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NEXT 
MONTH 


We are still restraining a review of 
PROSPERO PASCAL for 
programmers, a ONE MAN'S SYSTEM 
about Archive, lots of reviews 
including a new public domain 
collection, and some programs. We are 
also lining up book reviews and a 
Christmas present list! 


ext®’ should now be available in 
its Plus-4 version, for all QLs and 
the Atari QL emulator. There are 
many changes from version 3, among 
which are a revised, two-level menu struc- 
ture (simple and advanced), forward and 
backward searching, multiple windows 
onto one document or for several docu- 
ments, on-screen help, revamped 
dictionary word selection, and the ability to 
accept longer subdirectory names. By now, 
tex’ is a well-established and mature prod- 
uct, with many user suggestions having 
already been taken account of, but all the 
new features are very welcome and use- 
ful. A hands-on report on the new version 
will follow shortly. 

QL users really have a very good range 
of wp programs available to them now, 
something for every occasion, except per- 
haps the almost-dtp situations where 
greater flexibility and convenience of im- 
porting, editing and positioning graphics is 
needed. 

The back-up program WinBack from 
Dilwyn Jones Computing (DJC) has been 
upgraded to version 1.11. Several bugs 
have been fixed and a change made, 
which will be helpful to users of the PC 
emulator Conqueror, in that large files can 
be skipped during a backup; this caters for 
the one large file created on hard disk for 
use by MS-DOS. While this can be consid- 
ered as being, effectively, a partition of the 
drive, Qdos sees itas afile and will attempt 
to back it up — however many megabytes 
it may be in size — with the original version 
of WinBack. Purchasers of earlier ver- 
sions can obtain V1.11 by sending their 
current program disk with a stamped, self- 
addressed envelope, to DJC. A version 2 
is under development: it will allow files to 
be split across disks and compressed, 
thereby reducing the number of disks re- 
quired for backup. 


Backup backs out 


One problem which came to light with 
the review copy in subsequent use was 
that a partially completed backup could 
leave the user high and dry if there was a 
stoppage because of WinBack coming 
across a corrupted file on the hard disk. 
When this happened, the backup was 
aborted, and could not be restarted be- 
cause the files which had already been 
backed up successfully had been marked 
as ‘archived’, causing them to be ignored 


Backups and bug 
detectors, Qimi fixes, 
EHD from Miracle, 
and replies from 
Bryan Davies 


on subsequent backup attempts (until such 
time as they had been modified). This 
point has been made to DJC and it is 
assumed a fix will be implemented. 
Corruption is normally an unlikely event 
with disk drives, but it has occurred sev- 
eral times in recent weeks with the hard 
disk on my system. Two instances were 
discovered by DJC programs — WinBack 
and The Gopher. Another instance, and a 
‘possible’, were flagged by a backup rou- 
tine included in the Quanta Sub hard disk 
utilities set. Some less-technically minded 
readers may be under the impression that 
‘corruption’ automatically indicates a use- 
less file, but this is not true. You can have 
errors in files which do not show them- 
selves for a long time. A simple example 
would be where one character of the text 
of amenu has been changed ina program 
file — eg F1 changed to F2 on the Quill 
menu display — and there would be no 
detrimental effect on operation of the pro- 
gram. You can also have a detrimental 
effect on operation of the program. You 
can also have a defective area on a disk; 
this may allow copying to it, but cause 
trouble when a file is read from it. This is a 
matter which usually doesn’t concern 
floppy disk users (if a disk persistently 
gives errors, you get rid of it) but it is 
obviously more serious for hard disk us- 
ers. It is possible to detect and mark bad 
areas ondisks but I don't know of any easy 
way for average users to do this. Has 
anyone got a simple method? Help may 
be forthcoming from Tony Tebby; it is 
understood he is writing a suitable utility. 
For anyone who is having trouble on a 
system which has both a Qimi mouse 
interface and a Gold Card fitted, and 
hasn't heard of a solution yet, Miracle 
Systems and Phil Borman of Quanta have 
advised that the solution to one problem is 
to remove the back-up battery from the 
Qimi and connect together the two termi- 
nals to which the battery was connected 
on the board. That is, remove the back-up 
function from the Qimi and reconnect the 
line which was previously broken for inser- 


tion of the battery. There is apparently 
some conflict between the two interfaces 
when checking the supply voltage (they 
have different reference levels). Should 
the GC be removed, or the Qimi fitted to a 
non-GC QL, ata later date, the battery has 
to be refitted if the back-up clock is re- 
quired. 

Adifferent problem has been noted when 
the GC and Qimi are together in asystem 
which is not using Qpac 2; the mouse 
apparently sends signals whenever it is 
moved, regardless of whether or not there 
is aprogram present to make use of them, 
and these ‘spurious’ signals seem able to 
cause crashes when various programs 
are running (one instance was a 
SuperBasic boot for QPac2!). 

A suggestion for trying to deal with un- 
satisfactory disk drive behaviour (eg with 
/s-height 3'/z2in Mitsubishi drives) after a 
GC is fitted is to vary the FLP_START 
parameter (if your disk interface has this 
command); a suggested value is 40. One 
snag to doing this is that you either have to 
type itin before the drives are accessed, or 
put it into a microdrive cartridge boot file, 
and this seems a bit defeatist for those of 
us who want our systems to start up, fully 
operational, automatically. 


Miracle go Extra High 


Miracle Systems have decided to sell ED 
(extra-high density) floppy drives as stand- 
ard, dropping both DD and HD drives. The 
ED drives can handle DD, HD and ED 
disks, so there was no real technical rea- 
son to continue supplying the other drive 
types. The only questions had been avail- 
ability and price. It would not have been 
unreasonable for Miracle to charge more 
for ED drives than for HD, but they have 
chosen to keep the price the same (£175 
in the UK), and their customers will no 
doubt appreciate that. The snag at present 
is that the promised delivery date for ED 
drives has been put back (by the manufac- 
turers) to about November. 

With the worry about the price of ED 
drives out of the way, the prospective 
purchaser can concentrate on the price of 
disks, to decide which type to buy. Miracle 
hope to be able to sell ED disks at a 
considerably better price than | have seen 
quoted previously. There are a couple of 
obvious yardsticks for judging how rea- 
sonable the price level is—howit compares 
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in pence/kilobyte with storage on a hard 
disk, and how it compares in pence/kilo- 
byte with storage on lower-density floppy 
disks. The only hard disk currently avail- 
able to most users for the QL is the 40 MB 
Miracle one, which costs £449 total in the 
U.K., that is, a simple pence/kilobyte ratio 
of 1.1. Using Miracle prices again, dual 
3'/2in high density (1.44 MB) floppy drives 
have cost £175; the pence/kilobyte ratio 
here, for enough disks to hold 40 MB, is 
about 0.47 based on disks costing 70 
pence each, and buying 28 of them). The 
comparative figure for ED looks like being 
about 0.50 initially. The above figures are 
rather higher than they would be for drives 
bought from Miracle, as the latter include 
10 disks in the price of each dual drive set 
bought. All the figures assume you already 
have a disk interface into which the drives 
can be plugged. Buyers who don't fancy 
the current price of ED disks can carry on 
using DD or HD disks, since this type of 
drive can cope with all three types of disk. 


Floppy vs hard disk 


There are some points to remember 
when making this comparison. Once a 
floppy drive has been paid for, the pence/ 
kilobyte ratio drops greatly as more disks 
are bought, whereas the ratio is unchang- 
ing with a hard disk. Additional HD floppy 
disks cost about 0.05 pence/kilobyte; for 
ED disks, the ratio would be 0.09. One 
interface handles just one hard disk, 
whereas it may handle up to twenty-four 
floppy drives, making the cost of a back-up 
very much lower for floppy than for hard 
disk. 

Careful calculations of the pennies may 
be washed away by other considerations, 
though. Dual floppy drives take much less 
space and are more easily located than 
the hard disk. The ED drive is said to be 
about as fast as the hard disk, removing 
one of the usual advantages of hard disk. 
DD and HD floppy disks are available 
anywhere, at competitive prices, whereas 
ED disks are hard to come by and not yet 
heavily discounted. DD disks are ‘univer- 
sal coinage’ — they can be swapped with 
anybody else who has a 3'/2in drive. 

The figures indicate there is merit in 
buying ED drives rather than hard disk, but 
HD (and DD) disks are somewhat more 
price-competitive. At this stage, the obvi- 
ous choice would seem to be to buy 
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extra-high density drives but uses DD or 
HD disks until the price of ED disks comes 
down further. The ED capacity allows sev- 
eral big programs to be fitted onto one 
(system) boot disk. The drives are physi- 
cally almost identical with DD/HD ones, so 
don't take up much space. DD and HD 
disks can be used on many other comput- 
ers — eg current PC types — but ED disks 
are not commonly used on other comput- 
ers as yet. Considering all the money that 
goes into PCs, it is surprising to find us 
being able to buy a drive which is not yet 
available to PC users in the UK. 


Small differences 


The visible physical differences between 
the three types of 3'/2in disk are small. 
Looking at the disk as you see it when 
inserting it into the drive, all three types 
have a small square cutout at the left-front 
corner, for the write-protect function. HD 
disks have the same size of cutout in the 
matching position at the right-front corner, 
which is used by an optical detector in the 
drive to establish that the disk is HD. ED 
disks have this same cutout but it is lo- 
cated slightly further down the right side 
towards the rear corner; that is, it is not 
symmetrical with the write-protect cutout 
as it is on HD disks. ED disks may also 
have a different magnetic coating to DD 
and HD. 

Miracle Systems mentioned that they 
sometimes get calls from customers, re- 
ferring to comments made in this column, 
and they have to point out that what was 
said is no longer valid. Bear in mind that 
whatever you read here was written four 
weeks or more before you see it, and a lot 
can happen between despatch of the col- 
umn and arrival of QL World on your 
doormat. What /s certainly a valid point is 
that Miracle have shipped only the 16 MHz 
versions of the Gold Card; rumours sug- 
gesting this is not the case should be 
ignored, 

There have been a few critical com- 
ments about the Minerva rom in this 
column. The reason for them was not any 
objection to the idea of Minerva, but the 
fact that it was causing too much trouble 
with existing software. As of mid-Septem- 
ber, | have been assured that a 
development stage has been reached 
where it is considered safe to send out an 
upgrade to existing users of versions prior 
to 1.80; see the TF Services adverts for 


details of cost (believed to be £5 or FOC, 
depending upon your version). The cur- 
rent Minerva version 1.92 is said to be 
compatible with the current Gold Card rom 
version 2,22. The conflict with the GC 
apparently did not apply to the Mk | Minerva 
— only to the Mk II. 

In the not-so-deliberate error depart- 
ment—apologies to Alf Kendall and anyone 
else who spotted my error (October Trou- 
bleshooter) in saying the Atari ST had a 
68008 CPU chip. As | had prefaced the 
number by ‘16-bit’, the chip number should 
have been 68000. My mind will never give 
up the logic that the higher the number the 
better the chip, as with 68000, 68020, 
68030, 68040, etc... 

Remember the Data Protection Act? | 
am assured that one of the side-effects of 
it is that suppliers who do not wish to 
register under the Act may not retain de- 
tails of their customers’ telephone 
numbers. It is ok to keep name and ad- 
dress together, but not to add the ‘phone 
number to them. The corollary of this is 
that you should always give your ‘phone 
number when leaving messages on sup- 
pliers’ answerphones. Don't expect them 
to have your number to hand. Having just 
been played a tape of a message from a 
customer, threatening to keep on calling a 
supplier until an answer is received, | can 
sympathise with the supplier. The caller 
gave no details of the reason for the call, 
no address and no ‘phone number — just 
his name. 


Readers’ letters 


The Serial 8056 printer might well come 
out top of the list if we checked what 
subjects had produced most correspond- 
ence with QL World. That shows how 
successful Dixons were in selling QL sys- 
tems when they were throwing in the 8056 
‘free’ (what was the total price — £1297). 
The letters now all deal with the matter of 
using fax machine paper in place of the 
original type; it seems likely the paper is no 
different. The printer does appear to need 
a paper roll with a core diameter of 13 mm 
(vein). There seems some debate about 
whether or not the roll width must be 216 
mm; most writers say spacers are needed 
if 210 mm-wide rolls are used, but at least 
one user says he has no trouble with that 
size, and doesn’t use spacers. Presum- 
ably the 50 m fax rolls are too large in 
diameter to fit the 8056, but 30m ones are 
acceptable. One suggestion is to search 
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out bulk users of fax paper and scrounge 
their cast-off rolls (assuming they throw 
away rolls before they are emptied — an 
expensive procedure, at about 3p per A4 
sheet.) 

Tony Morgan of Sensitised Coatings 
(see Information box) advises looking for 
Sharp fax rolls, as they are216mm x 30m, 
ona ‘/zincore. Their own price to QL users 
for three rolls is £10 plus postage and vat; 
the price per roll will be less if more than 
three are ordered. For anyone who has 
weakened and bought an Amstrad 9600 
fax machine at the current low price, their 
price for 210 mm x 30m rolls ona tin core 
is £36.66 including vat (postage paid) for 
a box of 12. Thatis, £2.60 per roll. Having 
just bought a box of these rolls, | can 
confirm the delivery is fast. 

F N Reece was good enough to send in 
a photocopy of the 8056 manual, for R 
Thompson. He advises going to Wilding 
Office Equipment to buy paper; he uses 
210 m-wide rolls and says they work fine 
in his 8056. A further operational point he 
makes is that he had trouble with charac- 
ters being missed out, and incorrect 
characters being printed, until he routed 
the printer cable away from the other 
cables in the QL system. It is also possible 
that his action in moving the cable actually 
fixed a bad connection, as faulty connec- 
tions are perhaps the most likely cause of 
erratic printouts. 

One more suggestion — look out for fax 


rolls at the All Formats Computer fairs. 
You may have to rewind paper if you can't 
get the right diameter or core size. Be 
careful to check prices, though; there are 
good deals (especially disk prices) but 
I've found quite a few items at these fairs 
costing appreciably more than they would 
from known mail-order companies. This 
comment doesn't apply to items sold by 
QL suppliers, fortunately. 
Gerard Phelan has been trying to wear 
his printer out again, sending me another 
monster letter—21 pages this time. One of 
his aims is to make clear to me the advan- 
tages of having a QL connected on-line to 
bulletin boards, and much of his letter 
consists of bulletin board messages, per- 
taining to QL problems. So far, having a 
QL on-line has been a bit like having a tv 
set for me — a subject easily ignored. The 
reasons are the same for both, and centre 
around the degree of involvement they 
seem to require of the participants. Quite 
simply. | don't have the spare time (or 
money). However, the set of Tandata units 
continues to sit within eye range, as it has 
done for a year or so, and a copy of T F 
Services Qualsoft Terminal program has 
recently surfaced nearby, so it looks as 
though the time has come. What’s the 
betting having Qconnect linked to the 
‘phone will upset the fax machine? 
Howard Clase (who answers queries 
on Psion program problems in QL World) 
suggests that Andrew Pratt might con- 


sider getting Howard's QL_Fount set of 
routines from the Quanta library, to help 
him create a Korean character fount. The 
routines would allow him to have Korean 
and English characters simultaneously, 
‘patched-into’ Quill. The 5 x 9 (screen) 
and 9 x 9 (printer) grids used for creating 
founts might prove a limitation, if Korean 
characters are complicated. 


INFORMATION 


WinBack: 

Dilwyn Jones Computing, 41 Bro 
Emrys, Tal-y-Bont, Bangor, Gwynedd 
LL57 3YT. Tel: (0248) 354023. 


Gold Card and extra-high density floppy 
drives: 


Miracle Systems Ltd., 25 Broughton 
Way, Osbaldwick, York YO1 3BG. Tel: 
(0904) 423986. 

Serial 8056, paper rolls: 

Sensitised Coatings Ltd., Bergen Way, 
North Lynn Industrial Estate, King's 
Lynn, Norfolk PE30 2JL. Tel: (0553) 
764836. Fax: (0553) 760377. 

fext®; 

Software®’, 33 Savernake Road, 
London NW3 2JU. Tel: (071) 267 2025. 


Care Electronics, Dept QL, 15 Holland 
Gardens, Garston, Watford, Herts. 
WD2 6UN. Tel: (0923) 894064. Fax: 
(0923) 672102. 
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Psion organiser via Psion comms [irik 


é SP1900 9 pin dot matrix, up to 192 cps, FX850 emulation - £130 
Canon Bi l0ex bubblejet, very high quality (36bapi), Ad size, - £259 
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INFORMATION 

Program: The QL Epic 
Adventure 

GCH Services 
Cwm Gwen Hall 
Pencader 

Dyfed 

Disk only, £12.00. 
512K+ QL only. 


Publisher: 


oadventure buffs, and 
I count myself among 
them, the arrival of a 
new adventure for the 
QL causes a stir of anticipation. 
For us, a week spent without 
travelling in strange computer 
lands overcoming mind- 
stretching puzzles is an empty 
one, meaningless and drab. 

How then would this new 

f}adventure by Andrew 
Pritchard fare? Would itmatch 
the high standards set by those 
QL adventure grandmasters, 
Alan Pemberton and Dave 
Watson? 

Iam very pleased to say that 
itis their equal, perhaps better. 

The story starts with you 
waking up inside your 
spaceship, EPIC1, which is 
returning home after a mission 
of exploration. Looking 
around, you realise that you 
are alone; all your companions 
are missing. Have they been 
kidnapped? Did they beam 
down to the nearby planet's 
surface in search of something? 
What has been happening 
while you have been in 
suspended animation? 

Needless to say, you will have 
to go to the planet yourself to 
search for them. As in all good 
adventures, the pathway is 
strewn with danger and 
confusion. 

Many problems have to be 
solved. How can the old man 
in the desert help you? What is 
written on the note tied to the 
bird's leg? What favour is it 
that the beautiful Danja 
requires of you in return for 
revealing the whereabouts of 
your companion, Lois? 

You will find yourselves 
trapped in a spider's web, 
exploring subterranean 
caverns, flying Flittercopters 


“tnot her fren 
named Lois, 


assed this wat anag ene 


ih ago. 


th to Essino! . 
to Feoellem her, 
Fer thi« favour, I 


ait. ha 
car. 


She travelled 
if you 
agenus 


fexpect one im return” 
‘Danja neds at a quard 
land he rests his hand on 


his sword. 


fo vou wee ear h poms A tee 
 Soittewtimem: & pew 3 seve aad a 


and entering sizange and silent 
cities. 

You will have to find out the 
magic property of the Crystal, 
barter for goods and use all 
your mental skills to reach 
Essinol, or your quest will be in 
vain. 

I'll give you no hints or clues 
because that would spoil a 
cracking good adventure. Just 
draw your map, which should 
be large enough to cover over 
70 locations, and be persistent. 
Remember, the lives of your 
friends depend upon you! 
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Behind a pile of recks (the only Feature 


for miles? is an old man. 
“People often wander im the desert . 


The guru says 
F teeag 


de not give me names” 


Desert . 


s* ask ahbowt danije 
> 


The whole program is of the 
text/graphics type written 
with a comprehensive 60 verb 
parser and illuminated with 
graphics conjured up by means 
of OL Real-Time Digitiser. The 
pictures which follow the script 
are therefore very lifelike and 
add greatly to the atmosphere 
of the story. Incidentally, full 
marks for some of the 


glamorous girls who appear 
throughout the epic! 

My verdict is excellent. 

QL Epic Adventure is 
absorbing, addictive and 
thoroughly playable. It 
representsa first class standard 
of writing. Any problems? Just 
the one, I can't leave it alone. 
Now, just how do I please 
Queen Danja? 
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Bristol Workshop 


The Great Bristol Workshop 
is coming again, 

This time by the Seaside, so 
let’s hope it won't rain! 

Bring all your old software or 
anything to sell, 

Bring all your old friends and 
your Granny as well! 


We've got demos in Basic 
and all QL arts, 

We'll have systems for sale 
and all sorts of parts, 

Some Arcade games for 
children, some good beer for 
Dad, 

Speakers and Technicians 
and that can’t be bad. 


It’s easy to get to, just down 
by the coast, 

The best in the country and 
that’s no idle boast, 

There'll be plenty to see 
there, we've invited the 
Trade, 


Just bring lots of money, and 
your bucket and spade! 


In November??!! My word, but 
they’re a tough race. OL World 
must formally dissociate itself 
from any suggestion that it is 
proper to sell your Granny, 
even at a Workshop of the es- 
teemed Quanta Bristol Group. 
However, we can reveal that 
the workshop will be held at 
the Walton Park Hotel, 
Clevedon — NOT at Bristol as 
formerly — on Sunday 17 No- 
vember from 10a.m. to 
5.30p.m. Access is from junc- 
tion 20 of the M5, and the hotel 
is on the seafront, just north of 
the pier. 

For advice about transport, 
phone Chris Gregory on 0272 
513653, for accommodation at 
the Walton Hotel phone 0272 
874 253, and for advice about 
poetry. .. no number has been 
given, but for a small fee we 
can name the culprit. 


For information about the 
QL Italy fair in December, please see 
Editor's Notebook on page 14. 
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Clever Cables 


Cablefix is the name of a type of 
adhesive-backed lightweight 
cable trunking. Advertised as 
being suitable for home, office, 
vehicle, boat, caravan, labora- 
tory and workshop use, the 
lengths of trunking are split 
along the back so that cable can 
be easily pressed in to the strips, 
which will adhere to most sur- 
faces, including paint and 
woodwork. Cornering is done 


with right-angled coupling 


pieces. Cablefix can be cut to 
length withscissors, and comes 
in two sizes, 5.5mm wide by 
5mm deep, and 8mm wide by 
5mm deep in packs of four one- 
metre strips for £11.95 inclu- 
sive of VAT. Colours available 
are white or dark brown. 

For moreinformation contact 
Cablefix Ltd., PO Box 66, 
Uckfield, E Sussex TN22 
3ANTel. 0825 812601.. 
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PEN WHANNEL 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


somebody with the answer, or just sound off 
about something which bothers you, write 
to: Open Channel, Sinclair OL World, 
116/120 Goswell Road, London EC1V 7QD. 


Lhave the Psion programs ona 
PC under the PCFour banner, 
and I have transferred proce- 
dures and data from my QL 
‘Family Tree’ over using 
Diskover. With the help of QL 
World I finally achieved this 
successfully, 

While it works fine with new 
data, and will open the trans- 
ferred data files successfully, I 
cannot get it to access the data 


available. 
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Editor’s notebook 


Thank you to everyone who has written with 
general or specific offers of help with 
readers’ queries. There are no standing 
orders. When | see something that fits the 
bill. | shall throw it at someone . You will 
hear it slap on your doormat. 

Don't forget, though, that there's nothing 
to stop anyone from responding at anytime 
to any query that appears for example in 
Open Channel, if you think you have a 
solution. The best ones will be run. 

Qitaly Club and SPEM are organising the 
third Italian Users' Meeting on Sunday 1 
December from 9.30am to 6.00pm at Via 
Ponchielli 26A, Turin, Italy. You can contact 
Dr. Bros Porenzi at Via Valerlana 44, 23010 
Berbenno, Italy, Tel. 139 342 492323 eve- 
nings and weekends. Information on ac- 
commodation and maps if required, is 


and process it. 1am no expert, 
but suspect the reason is that 
when the PC versions of the 
data files are created, linked 
index fields are also made. Be- 
cause these do not exist for the 
transferred files, it gives up. I 
would dearly like a solution to 
this problem, to save me from 
laborious entering of all my 
old data from scratch. 


Alan Toms 
Formby 
Liverpool 


Easy save! 


It's been a longish wait — since 
December — but at last Perfec- 
tion is with us in all its glory 
and, in my opinion, well worth 
every minute waiting. 

I received a pre-release copy 
at the last Leyland show, and 
even then it was full of prom- 
ise. I received my release ver- 
sion early this month and it 
worked, giving all the advan- 
tages of Quill for ease of use 
without the (and I mean this as 
no slight to another excellent 
program) somewhat involved 
control of text87, plus the usual 
speed and additional features 
we've grown used to with DP 
products. 

I did have the slight prob- 
lems in one or two areas, ini- 
tially. The Propub page inserter 
didn't work properly, the 
Configurator locked up at one 
point with Minerva and Qimi 
installed, but not with them 
absent, and | found that the 
auto-wrap refuses to allow 
leading spaces on a line, A let- 
ter to DP, and the first two 
were fixed. The third is a fea- 
ture of Perfection which is a 
little disconcerting at first but, 
with a multitude of ways to 
circumvent it, becomes no 
problem at all. 

In answer to Stanley 
Horowitz in the September 
edition, saving a document is 
even easier than in text87. 
Pressing CTRL/Spresents you 
with a prompt giving the last 
file name Loaded or Saved (or 
a blank for the first occasion). 
The filename can then be 
cleared by pressing F5, edited 
as normal or accepted as it is, 
and the Save carried out by 
pressing ENTER. 

The manual (only 104 pages!) 
closes with a quote: "If perfec- 


tion could be attained, it would 

not be worth having." The pro- 

gram definitely disputes that 
quote. 

Ken Davis 

Silverdale 

Lancs 


Editor's comment: And soon to... 


Unhandybook 


You have been giving a lot of 
space to Perfection, but you do 
not mention the handbook 
which goes with it. The hand- 
book illustrates to perfection 
how programmers can com- 
municate to computers with 
ease, but when they try to ex- 
plain things to humans, they 
get lost in a morass. 

Churchill in an introduction 
to a Manual of Admin, issued 
to RAF Commanders during 
the War, warned people about 
submitting reports which at the 
end of pages of reasoning, end 
with: "I therefore recom- 
mend...". He implores people 
to start with their recommen- 
dations and follow with their 
detailed reasonings. Most of 
the recommendations will be 
accepted without having to 
waste time reading them. I feel 
the same thing goes with hand- 
books. Start with straightfor- 
ward instructions on how to 
use the equipment, and follow 
it with detailed explanations. 

When writing private letters, 
I like to centre my address. In 
the opening paragraph of the 
handbook, it says: "Perfection 
is simple enough to use with- 
outa manual", soI pressed J on 
Menu 2. No way could! get my 
address to centre. After about 
an hour searching through the 
104-page handbook, I found 
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justification hidden in a page 
called ‘Line settings’ and there 
was nothing self-evident about 
its use. In fact, justification’ was 
conspicuous by its absence 
from any index. 

One of the best features of 
Perfection is its three menus. 
Why didn't they start the 
manual with simple straight- 
forward explanations of how 
touse the Menu items, and then 
go on to all the other clever 
tricks it can do? 

Captain Eric Starling 
West Kilbride 
Ayrshire 


Editor's comment: I have made 
enquiries, and Digital Precision 
will be issuing the Index to the 
Manual Shortly. As to why we 
give Perfection a lot of space, and 
why the Index wasn’t with us 
sooner, see David Drysdale's arti- 
cle on page 22! Manuals remain a 
universal source of woe to compu- 
ter users. Lagree with the findings 
of Messrs. Churchill and Starling 
on layout and indexing. However, 
we note that Capt. Starling did 
eventually find the section he was 
looking for. This is a quantum 
leap ahead of the kind of manual 
where vital information doesn't 
even exist. 


Errata 


Thank you for publishing my 
letter on Professional Publisher 
in the September issue. There 
are a couple of corrections that 
need to be made for the tech- 
nique I outlined to work. 1. At 
the end of the second para- 
graph, 'DTP text’ should read 
‘DTP_rext'’. In line 90 of the pro- 
gram listing, if$+CHR$(10) 
should read lf$=CHR$(10) (in 
capitals, LF$=CHS$(10)). 
Peter Hamill 
Elton 
Peterborough 


Editor's comment: Thank you for 
the helpful letter. The errors are 
ours. As a general hint to Open 
Channel contributors, if you are 
sending listings, please keep the 
column width compact and the 
print quality dark wherever possi- 
ble, so that we do not have to 
retype them. Another interesting 
statistic: while only 2% of the 
population hastens to respond to 
questionnaires, approximately 
99.998% of our correspondents 
send helpful letters which are a 
pleasure to read, even when they 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
of a 
260 REMark 
270 = 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 END DEFine TRUNC 


REMark 
REMark 


ae gs 


REMark > 
CLS: UNDER 1 
PRINT 
UNDER 
INP" 
INP 

INP ' 
INP 

INP 

PRINT 


0: PRINT 


Years","", 


Days","", 


1+p/100 

kO * q*y 
30*m + t 

INT (k*t/100) 
360/p 

k + n/d 


REMark 
PRINT " 


LOCal Var$ 


INPUT Var$; 

IF Var$="""" THEN 
Var=DefVal: 
ELSE Var=Var$ 

END IF 

END DEFine INP 


contain complaints or corrections. 
When we print a letter from a 
reader asking for help, we are often 
inundated with suggestions; some- 
times an answer pops up months 
after the request, from somebody 
who has remembered it. That's 
community spirit. 


I want to say how much I enjoy 
the Desktop program, which 
after much checking and coun- 
ter checking, runs as it should 
run. I still can't get the agenda 
working properly, but I get the 
feeling that the fact that items 
do not stick to the date given, 
but appear at random at other 
dates, must be due to the dif- 
ferent way of either inserting 
items by date or by priority. 
However, whatreally irritates 
me is the fact that, after load- 
ing, items 0 and 2 operate on 
command, but that when try- 
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Capital".c$,"",k0,1000 
Interest’ > "" 6", po 


te 


Months","", 
" days",t,27 


July 27, 


Interest Calculation on Daily Basis 


Franz Herrmann 1991 


REMark currency unit 


REMark e.g. 


— Input. = 


REMark 
REMark 
REMark 
REMark 
REMark 


years",y,2 : 
months",m,7_: 


—- Caliculation - 


REMark 
REMark 
REMark 
REMark 
: REMark 
REMark 


days of year 


— Output — 
Interest ="! c$;TRUNC (k-kO, 2) 
PRINT “" new Capital ="! c$;TRUNC(k, 2) 


REMark — Subroutines — 


PRINT Text$!'"(";Cur1$;DefVal;Cur2$;'"') 


PRINT Var;Cur2$ 


PRINT Cur2$ 


DEF ine FuNetion TRUNC (x,d) 
REMark does not round ! 
RETurn INT(10°d * x)/10°d 


ing to start items 1 or 2 (note- 
book or agenda) the program 
hangs. If no keys have been 
used yet, ESC brings you back to 
Archive, but once you have 
touched either the space bar or 
Return, thesystem hangs forever. 
The only way out I could find 
is, from the main menu, to 
choose 0 to exit, enter "let 
Guest$="notepad" and run 
Desktop again, after which, 
choosing no. 1 from the main 
menubringsona flashing screen 
that is not quite correct, but in 
the first screen of this program 
either part of the magazine print 
got lost, or was not complete. I 
wonder whether others have the 
same problemand ifso whether 
there was a solution. 
Notwithstanding the above, | 
am impressed with this program 
and would love some more. 
Albert van Rheenen 
Amsterdam 
Netherlands 


“DM " 


for Germany 


“Interest Calculation on Daily Basis" 


start capital 

annual interest rate 
years \ 
months : 
days / 


time 


interest factor 
annual interest 


interest number 
interest divisor 
daily interest 


DEFine PROCedure INP (Text$,Curl$,Cur2$,Var,DefVal) 
REMark simple input routine, 
REMark over default value or type in value 


press <RETURN> to take 


“;Curls; 


Editor’s comment: Robin 
Stevenson dealt with two or three 
specific enquiries about the Desktop 
suite, none of which were the same as 
this one. I will put him onto it. 


In QL World August 1991, Mr 
Patterson asked for a program 
to calculate interest on a daily 
basis. As his problem sounded 
interesting to me, I found out 
about the methods commonly 
used by banks and wrote a 
small program which might be 
a first step to help. Mr 
Patterson, however, mentions 
something concerning credits 
and building societies which I 
did not understand fully; for 
the interest calculations, a year 
consists of 12 months of 30 
days, ie 360 days. 
Franz Herrmann 
Ockenfels 
Germany 
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North America 


kicking in the Uncharted Lands ae a Big Water, reports Robin Stevenson. 


BB iccing: primitive living conditions (NTSC), the Lost Tribes of QL are alive and 


he QL was first officially made 

available in North America in the 

spring of 1985, a year after its UK 

launch, or to put it another way, six 
months after it was available in Britain. In 
its journey across the Atlantic, it under- 
went a number of changes. 

The US version was built by Samsung in 
Korea. To meet the tough electrical inter- 
ference laws it acquired some metal shield- 
ing in the case, and some undocumented 
capacitors. The tv video signal was altered 
to the 60 Hz NTSC standard, and the JSU 
rom messed about with the graphics coor- 
dinate system to suit. Also, forno apparent 
reason except an outbreak of common 
sense, the BT-style serial and control ports 
were replaced with standard 9-pin D sock- 
ets. It went on sale at $500, substantially 
less than the £400 price in the UK at that 
time. 


Undeserved notoriety 


Other than that, the US QL would be 
instantly recognisable to a European user. 
Unfortunately, there was also the familiar 
proportion of unreliable machines, and the 
QL acquired the same undeserved 
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notoriety, which it was not given time to 
dispel. By 1987, Sinclair had sold out to 
Amstrad and most North American stock 
ended up with A+ Computers. Interestingly, 
they also acquired the North American 
rights to Qdos, which were not included in 
the Amstrad deal. They were able to pro- 
duce adevelopment of the JSU rom known 
as MGUS. This Europeanised some of the 
US features, such as the quirky graphics, 
and Americanised some of the other bits, 
such as the error messages. For example, 
instead of the bland 'PROC/FN cleared’, 
you will get 'I've forgotten what | was 
doing’! 

On the periodicals side, Sinclair User 
magazine and Time Designs magazine 
both gave the QL good coverage, and for 
three years there was a dedicated 
magazine, Quantum Levels from 
Syncware Systems. Alas, all of these are 
now defunct, but Update Magazine (see 
below) and Vulcan's Computer Monthly 
continue to cover QL topics. 

It is very unclear how many JSU QLs 
were produced. The most quoted figure 
seems to be 9000 actually imported, with 
a long standing rumour of another 1000 
languishing in a Far-Eastern warehouse. 


As to the number of current users, that is 
anybody's guess. The answer seems to 
be: enough to support a good user-group 
network, but not enough to sustain a full- 
blown industry. 

One interesting difference from the UK 
scene is the closeness of the QL to its 
Sinclair siblings. Sold under the Timex 
badge as the T/S 2068, the Sinclair 
Spectrum continues to sustain a good 
following there, despite being unsupported 
by Timex since before the QL came on the 
scene. User groups, publications and 
suppliers often combine a specialism in 
both computers, and many users moved 
up to the QL out of brand loyalty. The 
loyalty of both QL users and suppliers is 
fast becoming legendary. There may not 
be many newcomers to the scene of late, 
but as one supplier put it, ‘Most defectors 
these days go by way of a pine box.’ 


Multiple mothers 


As elsewhere, the QL is used in a vast 
range of situations. From homes and hob- 
bies to businesses, colleges and science 
labs someone somewhere is using a QL. 
One favourite and apparently true story is 
that Cray Computers (makers of huge 
supercomputers) carried out research into 
parallel processing by ‘jury-rigging'adozen 
QL motherboards together. Perhaps this 
is the super-QL we've been looking for! 


High specifications 


As might be expected in such a prosper- 
ous country, most QLs are pretty highly 
specified. Printers, colour monitors, disk 
drives, modems, extramemory and toolkits, 
all are common, although hard disks, mice 
and QL networks remain rarities. The Mira- 
cle GoldCard looks set to be a big US hit. 
Reports are that it is already selling well. 

The Thor computer is, if anything, even 
more of a minority machine in the US than 
here in the UK. Peter Hale of EMSoft only 
knows of four users, with a total of ten 
machines between them. In particular he 
describes one Thor user with a huge 
medical database, for which he uses Ar- 
chive and a hard disk. Because of the 
importance of the data, itis networked toa 
second hard-disked Thor, to keep a full 
working backup of the system. 
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So how does the land lie as far as the QL 
is concerned? One of the most active 
areas, perhaps appropriately, is New Eng- 
land, inthe north-east corner of the country. 
Itwas from Newport, Rhode Island that the 
first QLs went on sale, sourced from the 
UK. Bob Dyl, who ran this concern, is still 
involved in the very active Sea Coast QL 
User Group. Having successfully got the 
QL Source Book off the ground (see be- 
low), this group has now launched an 
exciting new periodical, the /nternational 
QL Report. Published four to six times a 
year, with an annual subscription of $10 
North America, $20 rest of the world, this 
aims to give up-to-the-minute news, re- 
views, rumours, hints and tips on QL de- 
velopments around the world. 


Going East 


In neighbouring Massachusetts, there is 
the new and thriving New England Sinclair 
QL User group (NESQLUG), with a rapidly 
expanding membership inthe Boston Area. 
There is also the above-mentioned EMSoft, 
a software house run by Peter Hale, who 
has been very helpful and enthusiastic 
with information for this article. He spe- 
cialises in Archive applications but is also 
building up an impressive product list from 
third-party suppliers both home (USA) 
grown and from Europe. The wonderfully 
named Wood and Wind Computing also 
lives in nearby New Hampshire, producing 
a range of SuperBasic and Archive utili- 
ties. Bill Cable runs it, along with a 
wodworkinh business, from a circular log 
house he built himself. Itis heated by solar 
power and wood fires, and uses wind to 
generate the electricity to power his house 
and his QL — hence the name. 

Also east-coast, but further south, is 
Sharp's of Mechanicsville, Virginia. This is 
the major QL stockist for North America. In 
1989 they bought the QLs held by A+ 
Computers, and still hold stocks of new 
and reconditioned machines, supplying 
hardware and software from both sides of 
the Atlantic. 

Over on the Potomac River, in Alexan- 
dria, Virginia, is Tim Swenson, one of the 
classic hacker enthusiasts. After a work- 
ing day keeping 60 networked Unix 
workstations on friendly terms with each 
other, he spends his spare time program- 
ming his QL (along with his collection of 33 
lesser micros). Not only does he edit the 
Capitol Area Timex/Sinclairnewsletter, but 
also, as a sideline, publishes The QL 
Hacker's Journal. This is nota commercial 
concern, in fact he sends it out free 'as a 
service to the QL community’ aiming it at 
those who love writing code. Past issues 
have focused on SuperBasic and C, but 
I'm sure he'd love to hear from anyone 
sharing his programming enthusiasm. He 
is also interested in adding to his micro 
collection, so if you are looking to dispose 
of an old Dragon, Oric, Sord, etc., he may 
well be interested. His address, plus Email 
code, is in the contacts box. 
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THE QL IN NORTH AMERICA 


Looking further west, there is a hot-spot 
of QL activity around Lake Michigan. The 
hub of this activity seems to be Indiana, 
where Paul Holmgren and Frank Davis run 
ISTUG, a user group covering the whole 
Timex/Sinclair range. Putting theory into 
practice, they also run a business called 
Mechanical Affinity, own the rights to both 
Qdos and the Mgus rom modifications, 
provide a service modifying, repairing and 
upgrading US QLs, and supply eprom 
boards and battery backed clocks. As if 
that was not enough, Frank Davis is editor 
of Update Magazine. Founded in 1987, 
and with a strong QL component since 
1988, Frank took over the magazine in 
July 1990 and it remains a vital information 
lifeline for many users across the conti- 
nent. 

Other active groups in this part of middle 
America include SMUG in Milwaukee, and 
the Chicago Area Users Group, both on 
the banks of the lake. A new umbrella 
group, the Timex/Sinclair North American 
User groups, T/SNUG, has also recently 
formed, drawing together members from 
the area and producing a newsletter titled, 
rather intriguingly, ZXir QLive Alive. Don 
Lambert, the editor, is 'a dyed-in-the-wool 
TS 2086 (Spectrum) fan’, but there are 
plenty of QL enthusiasts to keep the record 
straight. 

Away in the far north-west, as far from 
New England as it is from the UK, is 
Oregon, home of CCATS, The Clackamas 
County Applied Training Society. Rod 
Gowen, who coordinates it, also runs a 
Timex/Sinclair based business, RMG En- 
terprise, of 1419'/2 7th Street, Oregon City. 
Why the half, | can't imagine. There is 
nothing half-hearted in his business. He is 
the last full-service Sinclair dealer in North 
America. Despite pessimism regarding its 
commercial prospects, he assures us, '! 
will continue to support the QL as long as 
possible, both through my business and 
my user group.’ 


Canada calling 


Canada has its QL users. EMSoft's mail- 
ing list only includes 16 of them, but there 
is enough interest to sustain the Toronto 
Sinclair User Club with a strong QL 
showing. There are plenty of other active 
individuals and groups spread across the 
continent. Rob Martin gallantly coordinates 
a five-man group in Gainsville, Florida. 
From Long Island, New York, to the woods 
of Idaho up in the rocky mountains, there 
is a continuing enthusiasm. 

To help unite and coordinate such peo- 
ple, and also to link up the many users 
whose QL horizon stops at the study door, 
Sea Coast QL User Group have collated 
the QL Survivor's Source Book. This cov- 
ers QL-specific hardware, software, publi- 
cations and user groups not just for North 
America, but right around the world. They 
have made their information available to a 
number of representatives in Europe, to 
help make the QL community more of a 


global village. Richard Taylor, one of the 
instigators, is very enthusiastic about the 
prospect of drawing such interest together. 
He says, ‘As information spreads more 
and more users keep coming out of the 
woodwork. ' If your bit of wood seems iso- 
lated, I'm sure Richard, or any of the ad- 
dresses in the contacts box, would be 
delighted to hear from you. 


Contacts 
This is by no means an exhaustive list, 
but provides a range of organisations 
allof whom are known to be still around 
Many of the user groups produce their 
own newsletters on aregularb nd 
would welcome postal members. 


All addresses are ‘USA’ unless Canada is 
specified. 


Suppliers: 

EMSoft, PO Box 8763, Boston, MA 02114 
(Peter Hale is also a contact for 
NESQLUG). Tel: 617-889-0830. 
Mechanical Affinity, 513 East Main Street, 
Peru IN 46970. Tel: 503-655-7484. 

RMG Enterprise, 1419'/2 7th Street, Or- 
egon City, OR 97045 (Rod Gowen is also 
a contact for CCATS group). 

Sharp's, PO Box 326, Mechanicsville, VA 
23111. Tel: 804-730-9697. 

Wood and Wind Computing, RR3 Box 92, 
Cornish, NH 03745. Tel: 603-675-2218. 


Information sources: 

International QL Report, 15 Kilburn Court, 
Newport, RI 02840. 

QHJ, the QL Hacker's Journal, Tim 
Swenson, 4773 W Braddock Road #3, 
Alexandria, VA 22311 (tswenson @ dgis. 
dtic. dla. mil) (also a contact for CCATS 
group). 

QL Survivor's Source Book, North Ameri- 
can supplier is Update Magazine. 
Update magazine, PO Box 1095, Peru, IN 
46970 (Frank Davis is also a contact for 
ISTUG). Tel: 603-675-2218. 

Vulcan's Computer Monthly, PO Box 55886 
Birmingham, AL. 

ZXir QLive Alive, ed. Don Lambert, T/ 
SNUG, 1301 Kiblinger Place, Auburn, IN 
46706. 


Other User Groups: 

Capitol District Timex/Sinclair Group, Fred 
Lewis, 5 Sherwood.Park Dr, Burnt Hills, 
NY 12027. 

Chicago Area Users Group, Bob Swoger, 
613 Parkside Circle, Streamwood, IL | 
60107. 

Gainsville Sinclair Group, Rob Martin, 508 
NW 35 Terrace, Gainsville, FL 32607. 
Sea Coast QL User Group, Richard Taylor, 
309 Holly Circle, Tiverton, RI 02878. 
SMUG, Bill Heberlein, 5052 N91st Street, 
Milwaukee, WI 53225. 

Toronto Sinclair User Club, Hugh H Howie, 
586 Oneida Dr, Burlington, Ontario, L7T 
3V3 Canada. 


BS FITWARE FILE 


ADDRESS 
LABEL 
PRINTER 


SLOWGOLD 


INFORMATION 
Program: Address Label Printer 
Publisher:Dilwyn Jones 
Computing 
41 Bro Emrys 
Tal-y-Bont 
Bangor 
Gwynedd 
£15.00. Microdrive 
or 3.5in, 5.25in 
floppy. 256K 
memory expansion 
required with 
ramdisk. 


he author, J H Ree, 

and I, quite by chance, 

bumped into each 

other at the excellent 
workshop put on by the South- 
ampton group. 

“What made you write this 
Address Label program?” I 
asked 

“Because I couldn't find a 
good one on the market,” he 
said with conviction. 

It was also by chance that I 
had also encountered the same 
problem. I am the Secretary of 
a club which has 250 members, 
and about a year ago I needed 
a good program to run the 
membership system and print 
bulk address labels. 

Initially I used the Quanta 
library program which ran 
under Archive, but it proved 
too erratic in label printing. No 
amount of tweaking could 
change its seemingly random 
line spacing. 

My solution was to buy a 
copy of Archivist which suited 
me to the ground. I was able to 
merge my existing Archive da- 
tabase file using a utility which 
came with the program. It 
proved perfect for my printing 
requirements. 

J] H Ree went one better. He 
wrote a bespoke program of 
great versatility which proved 
so good that Dilwyn Jones per- 
suaded him to launch it com- 
mercially. 

In essence, this is an Archive- 
driven utility which has a 
number of hidden benefits over 
similar ones. For a start, itstarts 


off by copying all the available 
database intoram. This notonly 
reduces the risk of losing it by 
means of a crash, but also 
speeds the retrieval up — quite 
a bonus with Archive utilities! 
The label width is configurable 
from 3.5in to 6in. Similarly the 
label height can be varied from 
1.5in to 4in. Also a full list of 
fields is available for use witha 
Mailmerge program. 

Coming from the Dilwyn 
Jones stable, as expected, the 
system has good configuration 
instructions for non-Epsom 
printers. It also boasts a auto- 
matic ordering of entries, auto- 
matic suppression of blank 
lines in an address on a label, 
and is suitable for both 9- and 
24-pin printers. 

How does it work? 

Firstly you load Archive in 
the usual way, then you type 
RUN “boot”. The screen asks 
you whether you wish to run 
from flp1_orflp2_. Youdecide 
by pressing the space bar. Al- 
most immediately the bespoke 
screen is displayed, showing 
the first record in the database. 

Commands are actioned by 
use of the first letter. This, of 
course, allows you to alter any 
of the displayed fields. It has 
the additional benefit that if a 
name is over 36 characters long, 
it willdoa test to see whether it 
will fit on two lines of the label. 

Inthe delete function, a novel 
idea is that a large X appears 
across the whole display to 
make sure you realise what you 
are about to do. 

Full marks also for a very 
useful and comprehensive 
manual. | was particularly im- 
pressed by the sections on 
printer configuration and the 
extensive guidelines on Error 
Reports. Help on data transfer 
recovery following computer 
crashes is also extensive. 

Address Label Printer is a 
simple-to-use, versatile and 
professionally-written utility. 
1 commend it to anyone who 
has large amounts of address 
labels to print. My only criti- 
cism is that he wrote it a year 
too late! 
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INFORMATION 
Program: Slowgold 
Publisher: GCH Services 
Cwm Gwen Hall 
Pencader 
Dyfed 
Disk £5.00 mdv 
£7.00. 


aving been totally 

pleased with my 

Miracle Systems 

Gold Card, [ find just 
one small drawback to this ex- 
cellent piece of hardware: it 
can be foo fast for some soft- 
ware, particularly arcade 
games. 

This is where a new program, 
Slowgold, very cleverly written 
by Norman Dunbar, forms a 
perfect complement. 

In essence, it is a procedure 
which allows you toslow down 
the speed of your QL so that 
some programs become easier 
to use. If was written on the 
suggestion of Dilwyn Jones. 

The other bene re that it 
will slow down non-Gold Card 
systems as well... Do you 
want to get a high score on 
Diamonds? 

You have 15 choices of speeds 
and all are controlled by a few 
linesin your boot program. You 
call up the routine by: 


10 LRESP 
GOLD_BIN 


FLP1_ SLOW- 


[If youdon'thave Toolkif2 then 
a small Superbasic program is 
provided for loading. Then 


you type: 


20 GO_ SLOW 


followed by: 


30 SLOW 15 (or any number 
between 1 and 15) 


and that's it... the line num- 
bers are of course examples. 

If at some point during the 
particular program you wish 
to take the restrictions off then 
its just a case of: 


40 NO. SLOW 


and back to normal. Should you 
require it, you can put: 


50 HOW _ SLOW 
or more properly ... 


50 PRINT' The delay factor is’ 
& HOW SLOW' 


Forthe more technical of you, 
the routines work by putting a 
small delay in the 50/60Hz in- 
terrupts. They will not work 
on games and other programs 
that knock out these interrupts, 
such as early OL games. The 
code is not re-entrant or 
rommable as it contains data 
area within the code, 

Slowgoldisa very simple and 
foolproof system which is 
worth every bit of its £5.00 
asking price. Buying a Gold 
Card? Then Slowgold is a 
necessary and most beneficial 
accessory 5 


PRICE OF PERFECTION 


Freddy Vachha’s word 
processor Perfection 
took over £250,000 
worth of programming 
time to complete. 
David Drysdale asks 
him whether he thinks 
it was worth it. 


ave you ever seen anything as 
sexy as that?’ asked Freddy 
Vachha excitedly as he flashed 
his ruby-bright Perfection cursor 
to and fro across a QL monitor screen at 
Digital Precision’s London headquarters. 

It left me unimpressed, so he patiently 
explained that a whole month’s expensive 
programming time had gone into making 
that flicker-free Perfection cursor move 
with such smoothness and precision. 

| use Perfection myself and find itto be a 
cracker of a program. Its designers, how- 
ever, seemed to have a fanatical degree of 
dedication to technical minutae and this 
was why | had come to interview Freddy. 
| was not there to review the program, but 
to look at the concepts behind Perfection, 
to ask about his nit-picking obsession with 
detail and to question the program's com- 
mercial viability — particularly in the now 
rather restricted QL marketplace. 

| put the Rolls-Royce legend to Freddy. 
At one stage of its development it is said 
that Rolls-Royce invested so much time 
and effort in striving for products of unsur- 
passed quality that other business and 
financial considerations became second- 
ary and they found themselves getting into 
financial trouble. Could this, | wondered, 
ever happen at Digital Precision? 

‘You are quite right’, Freddy replied with 
achuckle, ‘to compare us with Rolls-Royce. 
A lot of the product philosophy is similar. 
Like them, we don't believe in cutting cor- 
ners and this is often unknown to the 
public even though they benefit from it. 


22 


The Price of 
Perfection 


‘One example of this is in Eye-Q, our 
graphics program. When we designed Eye- 
Q we made it fit the frequency of direction 
change in the cursor movement. This 
means that the cursor accelerates as you 
keep the key pressed. However the pro- 
gram also senses how often you over- 
shoot your mark and have to come back, 
and it adjusts its speed accordingly. This 
gives the user the sense of being a good 
artist, completely unaware of the help be- 
ing given by the program. 

‘As far as the “rather restricted” QL mar- 
ket is concerned, | would remind you that 
there were about a quarter of a million QL 
computers in circulation and initially Dig- 
ital Precision’s choice of the QL was a 
logical one — from a financial view also. 
The QL was an excellent computer and 


Sinclair had it as his top-of-the-range ma- 
chine. Its predecessor, the Spectrum, had 
already sold more than any other micro in 
the world — in fact twice as many as its 
nearest competitor. 

‘However, things went wrong. Sinclair 
came out with an electric tricycle, and 
eventualy sold out to Amstrad. 

‘At this point lots of people considered 
the QL to be dead but | thought otherwise. 
Apart from the non-trivial number of ma- 
chines in circulation another factor had a 
great bearing on my decision to carry on 
supporting the QL. Throughout this pe- 
riod, alongside my Digital Precision activi- 
ties, | had been acting as a computer 
consultant producing software for other 
computers. This gave me a considerable 
edge in the QL field because | knew just 
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what was going on in the rest of the micro- 
computer and minicomputer market. This 
not only convinced me that the QL was an 
excellent machine but that it simply did not 
have its equal anywhere else. 

*'The QL was the best computer of all for 
practicaluse. Others, like the Amiga, might 
give you 64,000 colours on the screen at 
any one time but, for practical purposes, 
most people would settle for the QL's four 
or eight. Again, the Amiga has very nice 
sound and the QL sound is ludicrous, but 
how many people really want sound? 


Development 


‘For practical use then, the QL was an 
excellent machine in an excellent devel- 
opment environment and there was no 
logical reason to move away from it, pro- 
vided our company was making some 
money. The argument could be raised, of 
course, that more money could be made 
elsewhere, but that is an issue that will 
have to be considered as time progresses. 
Digital Precision is still devoted to produc- 
ing QL software. 

‘It was against this background that we 
decided to produce a highly superior word 
processor for the QL and to call it Perfec- 
tion. This was undoubtedly needed be- 
cause, for allits user-friendliness, Quil/had 
many disadvantages and this went for all 
the other QL word processors too, as far 
as we were concerned. 

‘Users have been completely spoilt by 
Quill because of its utter simplicity. It does 
not, however, have any growth area. When 
you first start using the program it is fine 
but you find to your horror a week later 
when you want it to do something a little 
more exciting that it just cannot happen. 
Quill's other weakness lies in its sheer 
illogicality. 


Search facility 


‘An example of this is the search facility. 
\f you find something you wish to edit on 
the fifth occurrence then, although you 
wish to continue the search, Quill will make 
you abortit. In order, then, to edit the sixth 
occurrence you have to go back to the first 
one again, and the second, and the third 
and so on, which is all completely illogical. 
Again, if you are using Quill on anything 
longer than a two-page letter it becomes 
grossly unwieldy. 

‘Another alternative to Quill — our own 
beloved Editor— also has drawbacks. To 
begin with it is not primarily a word proces- 
sor. It would have been labelled ‘Word 
Processor’ and not ‘Editor’ had it been so. 
It is a superb program for the technical 
user and although it will accomplish many 
word-processing tasks it does not have 
wysiwyg (what you see is what you get), 
which is an essential requirement for most 
users. If, for example, you wish to print a 
word in italics on Editor it will not appear as 
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italics on the screen but be made to printin 
italics by embedded control codes. The 
trouble with control codes is that they 
screw up your apparent justification on the 
screen. For straightforward word- 
processing this was too complicated. 

Another popular word processor available 
on the QL is text87, a complex program 
which can present difficulties to non-tech- 
nical users weaned on Quill. 

‘Neither of these three programs gave 
any sort of positive modelling for the devel- 
opment of Perfection, although it was de- 
cided that the simplicity of Quill had to be 
maintained throughout the project. It was 
also decided that Perfection had to be so 
constructed that it could stand alone and 
be used without referring to the manual — 
while still being of equivalent power to the 
top PC word processors like AmiPro, Word 
and WordPerfect. 

Although advantageous to the user, this 
latter facility had grave disadvantages for 
Digital Precision — it made piracy and 
unlawful copying of the program far more 
likely. ‘We then considered some form of 
copy protection but all the methods avail- 
able make life difficult for the user and the 
program becomes less user friendly — a 
direct contradiction to what we were trying 
to achieve. We just could not, we decided, 
go along with that. It was also unfair to 
penalise the honest user in our attempts to 
thwart the dishonest. 


Compact power 


‘Perfection was conceived and very lightly 
specified by me and produced and pro- 
grammed by a team led by Steve Sutton, 
a very gifted machine code programmer 
— possibly the best machine code pro- 
grammer who has ever written for the QL. 
Other team members were Nigel Davies 
and myself. 

‘Writing a program entirely in machine 
code gives it great power within a relatively 
small space. It also gives it much greater 
speed enabling it, for example, to search 
for something at the bottom of a 350 K file 
and find it in just one second. 

‘We had about eight consultants who 
were unpaid and who ranged from compu- 
ter experts to computer idiots. .. who gave 
their opinions on the development of the 
program. 

‘Now, we listened far more carefully to 
the idiots than to the boffins. They often 
came up with interesting points which we 
would never have thought of. Making an 
idiot-proof program, as well as writing an 
idiot-proof manual, is almost impossible. 
They are clever, unbelievably clever, at 
finding ways of interpreting things. No 
matter how we try they will always find 
ways of misunderstanding things and when 
we make clarifications they find ways of 
misunderstanding the clarifications! 

‘The development of Perfection began in 
late 1988 when Steve and | got together to 
discuss what we'd like the program to do. 


PRICE OF PERFECTION 


Actual programming work began in 1989, 
so you must realise that this product has 
taken two years to complete. It progressed 
slowly, but steadily, and took much more 
time than we planned. 


Consumed 


‘We had called the program Perfection 
and somehow the quest for perfection 
began to consume us. That cursor for 
example. You willnever have seen a cursor 
like it but itis difficult to imagine that it took 
a whole month’s work to attain. We had, in 
fact, achieved 80% of its qualities within 
the first three days. We could have left it at 
that and few people would ever have no- 
ticed. However, we carried on and spent 
another 27 days achieving the other 20%. 

‘Time is money and Perfection took three 
or four thousand hours of programming 
time to achieve. Trying to work out this cost 
theoretically means establishing the com- 
mercial pay rates for the programming 
skills involved. This consisted of highly 
complex machine code programming ina 
multitasking environment. 

‘Perfection is not one program but always 
between two and four programs running 
simultaneously with communications 
protocols between them. This is far be- 
yond the capabilities of the average ad- 
vanced programmer and so we are talking 
about a pay rate of about seventy-five 
pounds an hour! A total sum of over a 
quarter of a million pounds is not too much 
to think about. 

‘There is, obviously, no way we can earn 
any such amount and so, by any measure, 
Perfectionis notcommercially viable. There 
are, however, intangible benefits both to 
us and to QL users. With products like 
Perfection no intelligent QL owner can 
ever think of discarding the QL in favour of 
aPC and that, in turn, must help to secure 
our marketing base. 

‘Finally, you ask whether we would do it 
again and the answer must be “no”. It’s 
been too hard. It’s taken too muchtime. It’s 
cost blood. OK, we've done it and it’s 
wonderful — for us and for everybody — 
but we have paid a high price. Steve and 
| have been devastated, utterly devas- 
tated, by the production of Perfection.’ 


A towel unthrown 


Despite his efforts over two years, Freddy 
Vachha does not sound like a man who is 
about to throw in the towel and rest on his 
laurels. So what is he going to do next? 

‘We are even now in the process of 
preparing some new products which could 
be quite exciting. We are also getting 
ready some ex-PDQL stuff from Chas 
Dillon to go back on the market,’ he says. 
Not so Olympian as Perfection, perhaps, 
but it shows that Digital Precision are 
continuing to keep their eye firmly on the 
ball, even if they need matchsticks to prop 
them open! 


Italy calls to the world 


Davide Santachiara of Ergon 
Development in Italy has con- 
tacted QL World with upgrade, 
price and payment details on 
their software list. 

There is an active QL scene in 
Italy, but interaction between 
the Italians and the rest of the 
world has suffered from dis- 
tance and high currency con- 
version charges. Santachiara has 
some advice to make the best of 
this situation. 

Ergon’s list includes DEA In- 
telligent Disassembler, 


| MasterBasic, SB QL Library 
Manager,and Music Manager (the 
latter two reviewed in recent 
issues of QL World). 


All the English manuals have 
been revised and updated; new 
copies cost £4 each, plus bank 
and carriage —_ charges. 
MasterBasic aid for SuperBasic 
programmers is now into ver- 
sion 1.30, is compatible with 


Minerva tokenisation and has 
been debugged and improved 
‘drastically’. Owners of the more 
recent versions of MasterBasic 
can obtain the new version and 
manual for £7 plus conversion 
and carriage. Other prices are: 
DEA V4.07 £29, QL Library 
Manager V2.0 £25, MasterBasic 
V1.03 £25, Music Manager V1.2 
£10. All programs listed except 
DEA are available on mdv as 
well as disk, for an extra charge 
of £2 for the cassette. Orders of 
two programs can claim £2 off, 
three gets £3 off, four gets £6 off, 
buying QLM and MBS together 
gets an extra £2 off plus a free 
Window Definer. Add £5 to the 
total order for carriage (which 
will be by airmail in Europe or 
surface mail). Add £4 conver- 
sion if sending a Eurocheque or 
any cheque drawn ona currency 
other than lire. To avoid conver- 
sion charges, send a Eurocheque 


in lire, at the equivalent rate of 
2,300 lire to £1 Sterling. If in 
doubt, ask the foreign section at 
your bank. 

Santachiara goes on to explain 
why Ergon has not publicised 
its list more widely in the UK: 
“Our programs (except Music 
Manager) are devoted mainly 
to experienced programmers: 
QLM and MBS for SuperBasic 
and DEA for machine coded. 
Also, thereis an understandable 
fear of non-UK software houses 
(because of the distance). Al- 
though current versions of DEA, 
MBS and QLM are at a very 
good quality level, they have a 
restricted market. A software 
house must also gain a good 
reputation, and this can only be 
achieved after a time. Though 
we have approached the UK 
market only recently, | am op- 
timistic and would like to do it 
properly. In Italy [have sold QL 


programs — Music Manager, 
PT Manager (a simple data- 
base), StoreHouse OL Con- 
nection and others — since 
1988, so I have a bit of experi- 
ence. 

‘Twould also like to add that 
in Italy there are other people 
working on strange and eso- 
teric but very professional 
projects on the QL. lam trying 
to bring these projects gradu- 
ally to light and give the au- 
thors a little economic recog- 
nition as well as personal sat- 
isfaction. 

Ergon also offer upgrade 
deals and airmail delivery 
elsewhere. For more informa- 
tion, contact Ergon Develop- 
ment, Davide Santachiara, 
Via Emilio De Marchi 2, I 
42100 Reggio Emilia, Italy for 
a leaflet. A suitable Interna- 
tional Reply Coupon would 
doubtless be appreciated. 


All Format 
Dates 


The next few All Formats Com 
puter Fairs will take place at the 
following times and venues: 
December 1, City Hall, 
Candleriggs, Glasgow; 

ber 14, Horticultural Hall, West 
minster, London; December 15, 
University Sports Centre, Leeds. 
All fairs run from 10am to 4pm, 
admission is £4, and informa- 
tionand advanced tickets can be 
obtained from John Riding on 
0225 868100. 

The organisers of the Fair are 
so pleased with the success of 
the regional venues that they 
now intend to host around five 
shows a year at each of them, 
with new venues to be added. 


° 


Quanta however has stated 
that, because OL attendance is 
concentrating on the London 
Fair, they ‘may follow the lead 
of other QL traders and only 
attend London fairs in future, 
to reduce costs,’ This makes a 
certain sense, as Quanta holds 
regional meetings of its own 
when organisers can be found; 
it is to be hoped that OL trad 
ers based in the North will be 
able to continue to attend 
northern fairs. 

Ironically, Quanta also re- 
ports a lack of volunteers to 
hold a workshop ‘furthernorth 
than our current range’. 
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ANIMATION AND FRACTALS 


: Miation 


carci 


Simon Goodwin explores 


QL animation and fractal 
graphics. 


his article features three short 
programs that generate intricate 
graphics patterns and effects with 
simple SuperBasic loops. Two of 


programs use a black background. This 
gives best contrast and apparent depth, 
and the image appears larger because the 
border around the screen pixels is black. 
Monitors, tv, video recorders and human 
eyes have their highest resolution in 
monochrome, rather than colour. 

The brain and the eye associate area of 
matching colour, so that is an effective 


res 


It is often a mistake to use two adjacent 
colours for INK and background. If the 
brightness is similar — as for red and 
green in MODE 4, or cyan and green in 
MODE 8 — poor screens will not show 
edges accurately. This obscures detail, 
although it can improve the effect of stip- 
ples. A difference of three or more in Qdos 
colour value, 0 — 7, should ensure strong 
contrast on most screens; if in doubt, re- 
member that bright colour pairs merge 
most easily. 


If you get tired of the usual QL display 
colours you might shuffle connections in 
your RGB monitor lead. Exchange the 
blue and red connections to get blue in- 
stead of red in Mode 4, and a MODE 8 
brightness sequence that goes 0, 2, 1, 3, 
4, 6, 5, 7! This makes a change, but some 
programs may look worse as a result. 

More complicated arrangements pub- 


the programs make ‘fractal’ displays: self- way to distinguish sections of a picture. 
referential images with infinitely detailed | This effect extends to simple patterns, so 
features. the QL’s 256 ‘stippled’ advance on the 
These loops illustrate major styles of eight binary combinations of blue, red and 
programming; one is iterative, the other green. Listing one uses colour to 
recursive. The final program generates distinguish between mixtures of two colours 
multicoloured, moving patterns thatbounce are a welcome successive plots. Listing 
around the screen or any window. three cycles through the full colour range, 
SuperBasic supports a plethora of at varying intervals. 
graphics commands, built-in and available 
as Toolkit extensions. Some commands 
use pixel coordinates in a window, like 
BLOCK and the DIY Toolkit extensions 
PLOT and DRAW. Pixel coordinates are 
used in the second and third listings. 
The rom graphics routines were originally ° 
programmed for Sinclair by GST, and re- 
tained from the prototype software when 
Tony Tebby’s Qdos was chosen for the 
final model. POINT and LINE are relatively 
slow but sophisticated. They allow deci- 
mal coordinates, shifting, scaling and clip- 
ping arcs and lines in the window. 
SuperBasic supplies a further layer of 
contro! for listing one adding ‘turtle 
graphics’ commands to the Qdos reper- 
toire. These let you specify screen loca- 
tions with a mixture of distances and an- 
gles, in the styles of the versatile Big Trak 
computer toy or Logo, Seymour Papert's 
educational programming language. 


Colour choices 


With just eight possibilities (or 16 on a 
Thor XVI) QL colour choices may seem 
trivial, yet they repay thought. All these 
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ANIMATION AND FRACTALS 


lished in June’s Quanta, have used 
switches to reassign the colours. Spem’s 
QL Video Digitiser has three faders so you 
can set the level of individual RGB compo- 
nents, when using an analogue monitor. 

Amiga Qdos emulator 3.03 only supports 
MODE 4, which allows four colours. Nor- 
mally these correspond to the QL’s Black, 
Red, Green and White, but John Alexan- 
der tells me that each of these can be 
assigned from the full palette of 4096 
colours, using POKE_W commands to set 
the memory-mapped palette registers. | 
expect something similar can be done with 
Qdos on an ST, with 512 colours, or an 
STE, with a palette of 4096. 

The ‘C Curve’ is an intricate pattern with 
a simple-sounding name. It traces paths 
from one point to another alongside, using 
a succession of routes. Each path has 
more bend than the one before, and after 
a while intricate patterns appear en route. 

The first curve is a direct horizontal line 
between the two points. Each new curve 
replaces previous straight lines with two 
lines that meet at right-angles. 

The recursive rule is ideal for the QL’s 
inbuilt turtle graphics commands, which 
let you order an invisible pen around the 
screen with MOVE and TURN commands. 
Turtle graphics are not very fast, because 
of the extra calculations they involve, but 
they are valuable because they make some 
graphics programs much easier to write. 

Listing one gives the program, which 
runs on any QL or emulator. The C Curve 
is a continuous line, so each iteration 
starts by putting the ‘pen’ down on the 
screen, so that subsequent MOVE and 
TURN commands leave a trail across the 
screen. 

The first few curves are very simple. 
Figure one illustrates the first five routes 
starting with a straighttine, then achevron, 
a staple, and so on. All these are simple 
enough — but later the lines fold back on 
themselves, and interesting patterns 
appear. 

Figure two shows the 14th curve: 
a sequence of strange shapes, 
each resembling the ones 
around it in overall plan, and 
in details too. See the big §, 
pattern that hangs from the § 
topofthecurve, andthesmall } 
copy of it, upside down, near 
its bottom edge. : 

There are copies of that & 
shape at either end of the 
curve, and larger and small § 
versions all around. Rather 
like structures in the fi 
Mandelbrotset,eachpattern iim 
is flanked by minatures of 
itself, and so on down in # 
scale, to the limit of the plot. 

It is remarkable that such a 
detailed shape is generated by “® 
progressively adding corners to 
straight lines. The emerging theory 
of ‘chaos’ sets out to explain such 
miracles. There is no theoretical limit to 
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the intricacy of fractals, although display 
resolution and calculation delays constrain 
explorers. 

Listing one changes the INK for each 
curve, so you can build up acolour display. 
Press C to clear the screen and draw the 
next curve, or N to draw the next on top of 
the existing display. To run the program in 
MODE 8, replace ‘2’ with ‘1’ twice in line 
210. Line 160 sets the initial colour. Win- 
dow #1 should be wider than itis tall, or the 
right-hand end of the image will be cut off. 

Whatever the scale, the entire image is 
drawn by Gus Chandler's procedure 
C_CURVE, from line 370 to 440. This 
draws aline at agiven angle, breaking it up 
into sections if it is more than a certain 
limiting length. The same procedure draws 
every part, using two sections at 45 de- 
grees to the original angle, and adjusting 
the lengths to end up in the same place. 

Recursive programming is powerful, el- 
egant and favoured by computer scien- 
tists, but it is prohibited in new British 
Ministry of Defence rules for ‘safety criti- 
cal’ software. This will make some pro- 
grams harder to write than would other- 
wise be the case. | doubt they will be safer, 
but perhaps they will be easier to test, as 
a result. 


Sierpinski's Gasket 


The second program draws a symmetri- 
cal pattern known as Sierpinski'’s Gasket. 
It uses another simple rule to fill a triangu- 
lar area with a grid of triangles within 
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triangles that receeds to infinity. This is a 
simple two dimensional fractal related to 
the 3D Menger Sponge, which has infinite 
surface area and zero volume! 

Starting from a random point inside the 
triangle, plot the point on the screen, then 
step half the distance towards one of the 
three corners, chosen at random, and 
carry on from there. As successive points 
are randomly plotted they form into an 
infinite succession of regular nested trian- 
gles. The image seems to fade up from 
nowhere as the program runs. 

Some points are visited, others are not. A 
few ‘wild’ pixels are set if the initial point is 
not part of the pattern, but soon the pro- 
gram hits upon the underlying pattern, or 
fractal ‘attractor’; thereafter, all subsequent 
pixels fill in more and more of the gasket. 

The program runs forever, or at least until 
you reset, turn off the computer, or press 
CTRL and Space to stop SuperBasic. The 
longer it runs, the more complete the pic- 
ture, but you should get the idea in a few 
seconds. 

Listing two uses the fast PLOT com- 
mand introduced in the September 1989 
QL World. \f you lack that command you 
could use BLOCK 1,1,x%,y%,7 instead of 
PLOT x%,y% at line 250. Lines 170 to 190 
are optional; they use vector graphics to 
draw a triangular border. 

Lines 200 to 220 store the coordinates of 
the three corners of the triangle in an 
array, for convenience later. Each itera- 
tion of the loop from line 250 to 300 adds 
one point to the display. The next corner to 
be approached is determined by arandom 
number, 1, 2 or 3. 
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®@ REMark @DOS/ARGOS Kinetic String animation 
REMark By Simon N Goodwin, after Louis Cesa 


REMark Recursive SuperBasic C Curves 
REMark Gus Chandler & Simon N Goodwin 


: REMark Version @.9, tested 27th September 1991 
root 2=SORT 2) 
base=Ba 

| limit=89 a 
colour=2 f 


REMark Uses DIY Toolkit CHAN_WZ, CHAN 1, PLOT & DRAW 
REMark TURBO optimisation directives (up to line 220) 
IMPLICIT“ «1,x2,yl,y2,dx1,dx2,dy1,dy2,stripe,bounce 
IMPLICIT“ place,delta, limit,here,c,tx1,tx2,tyl,ty2 


INK colour : PAPER @ : MODE 
SCALE 116,-25,@ : CSIZE 6,@ 


REPeat curve 
eolour=colour+2 : 
INK col our 
REPeat keys 

k#=INKEYS (—1) 
IF k#=="e" =: STOP 
IF k#=="c" 3: BLANK 
IF k#=="n" OR k$=="c" 2 
END REPeat keys 
POINT 15, 2a 
PENDOWN 
xA=3G@ 3 yL=20 
C_CURVE base,@ 
limit=limit*.7 
END REPeat curve 
STOP 


DEFine PROCedure C_CURVE (length, angle) 


IF length < Limit 


TURNTO angle =: MOVE Length 


ELSE 


C_CURVE (length/root2), (angle+45) 
C_CURVE (length/root2), (angle—45) 


END IF 
END DEFine 


DEFine PROCedure BLANK 
CLS 
PRINT , 
PRINT “E to end" 

END DEFine 
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REMark SuperBasic Sierpinski Gasket 
REMark Gus Chandler & Simon Goodwin 
REMark Uses DIY Toolkit PLOT & DRAW 


REMark Tidy screen and 


MODE 4 : WINDOW 512, 254,4,@ 


INK 7 : PAPER @ =: CLS 
PLOT 6,255 
PLOT 256,@ 


DIM posé{(3,2) 


IF colour>7 : colour=2 


EXIT keys 


"N for next on top", 
"C for next, clear" 


DRAW 544,255 

DRAW 9,255 

PLOT 258,@ 2: DRAW 5@6,255 

REMark Store the corner co-ordinates 


IMPLICIT xmax, ynax,col,size 


IF COMPILED ¢ 


OPEN #1, "CON_512x254a@80.000" 


ELSE 


END IF 


WINDOW 512, 254,9,6 


INPUT "Pattern size"'size :REMark Maximum lines at once 
DIM c{size) ,tyilsize),tx2isize),tyl (size), ty2(size) 


OVER -1 : RANDOMISE 
xmax=CHAN_W2{#1,28)-1 
LET x1=168 : »2=2@@ : yi=RND(15@) : y2=RND(1@@ TO 125) 
dx2=-1 ¢ dyl=-1 : dy2=1 

bounce=1 


LET dxi=1 = 

LET stripe=i : 

REPeat animate 

FOR a=1 TO size 
INK cla) 


 ymax=CHAN_W%H1, 30) -1 


: col=7 


PLOT txi(a),tyita) 
DRAW tx2{a),ty2la) 
bouncesbounce-1 : stripe=stripe-1 


IF stripe=@ 


END IF 
IF bounce=8 


stripe=RND(S TO 5@) 
REPeat pick_colour 
col =RND{25S) 
IF CHAN_L (#1, 62) 
END REPeat pick_colour 


: INK col 
: EXIT pick_colour 


bounce=RND(5 TO 19@) 


IF RND(1) 


dxi=RND(~? TO 9) : 


ELSE 


dx2=RND(-9 TD 9) : 


END IF 
END IF 


dyi=RND{-4 TO 4) 


dy2=RND(~4 TO 4) 


ADVANCE xi,dxt,xmax : ADVANCE y1i,dy1, ymax 


INK col + 

txifadsxt = 

PLOT xl,yl : 
END FOR a 


578 END REPeat animate 


draw outline 568 : 


598 REFERENCE place,delta 


ADVANCE x2,dx2,xmax 3 ADVANCE y2,dy2, ymax 
cfla)=cal 

tyllad=yl 2 tx2(ad=n2 2 ty2(al=y2 
DRAW tx2la),ty2(a) 


660 DEFine PROCedure ADVANCE {place,delta, limit) 


619 LOCal here 
62@ here=placetdelta 


449 place=here 


658 END DEFine ADVANCE 


pos%(1,1)=8 : pos%(1,2)=255 


pos#(2,1)=50@ = pos%(2, 
pos4(3,1)=259 3 peszis, 
liom start point 


REMark Pick ara 
* =280+RND (188) 
Y=RND (100) +168 
REPeat iterate 
PLOT x,y 
corner=RND(1 TO 3) 
x=(x+posé4(corner,1)) 
y=(y+posiz (corner, 2) ) 
END REPeat iterate 


Listing three employs tricks that first 
appearedin video games, suchas Atari's 
classic abstract game QI/X, about a dec- 
ade ago. A moving bundle of lines tum- 
bles around the window, twisting, bounc- 
ing and changing colour as it moves. The 


| algorithm was described in the Novem- 


ber 1980 issue of Byte, abulky American 
computer magazine, but its elements 
can be traced back to the first tv games. 

Early video games had low display reso- 
lution, and very little processing power. 
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2)=255 
2)=8 They used hun- 
dreds of TTL 
chips, or later 
one Isi array, 
rather than a 
full-blown com- 
puter. It was fea- 
sible to display 
moving blocks, 
and game de- 
signers got 
used to bouncing them around the 
screen, first between ‘bats’ in tennis 
games and later from edges too, in games 
like TV Squash and Breakout. 

Louis Cesa’s Kinetic String algorithm 
expanded the moving dot idea to suit 
improved screen resolution by drawing 
lines between two moving points. As 
successive lines are drawn the points 
converge, diverge, or bounce; the eye 
and brain interpret the patterns as sur- 
faces defining planes in three dimen- 


ro 
42 


630 IF here<@ OR here>limit : 


here=place : delta=-delta 


sions. Curves and stripes are overlaid by 
interference ‘beats’ between the screen 
resolution, stipple colours and diagonal 
lines. 

This is a good start, but it’s only a half 
of the secret. If the program keeps on 
drawing lines the screen will soon fill up, 
and the sense of movement and per- 
spective will be lost as the screen fills 
with a jumble of colour. 

Listing three gives the impression of a 
moving object because it stores the co- 
ordinates of each line as itis drawn. After 
a certain number of lines has appeared 
it starts to ‘undraw’ earlier lines, so the 
whole pattern appears to move. Once a 
line has disappeared the storage space 
used to hold its details can be re-used for 
a new line. 

The Byte article is vague about the 
method used to ‘undraw’ a line, but this 
turns out to be quite easy in SuperBasic. 
We could just overdraw the previous line 
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in black — but this deletes any back- 
ground, perhaps including other lines that 
have been drawn more recently. 

Instead, | set OVER -1 before plotting 
any lines, and draw the line again, in the 
same colour, to erase it. This restores the 
old background, so several bundles can 
wander around a single window. 

Every so often a new INK colour is 
chosen, or the course of one of the points 
changes, so there is no risk of the pattern 
getting stuck. These events are intro- 
duced at random intervals, and their fre- 
quency is a matter of taste — adjust the 

»ndom numbers to suit yourself. 

Stipple colours that result in an ink mask 
of zero are excluded, as these are invis- 
ible when OVER -1 is set. The test on line 
400 uses the DIY Toolkit CHAN_L func- 
tion to detect an ‘all black’ mask. Lines 
380 and 410 repeat the test if necessary. 

Line 260 uses CHAN _W% to read the 
window height and width. Skip the test, 
and set the variables directly, in units of 
MODE 4 pixels, if you lack these func- 
tions, eg: 


260 xmax=511 : ymax=255 


and lose lines 380, 400, 410. 

Listing three uses all the stippled col- 
ours and fast PLOT and DRAW com- 
mands, You geta similar but slower effect 


ASTRO (NICK WARD] (astrology pragi (128k) (fipmev) £12.50 


0-DAY MK (DOG & AICH MELLOR) wargame) (256k) iflp) £15.00 


GREY WOLF [OLIVER NEEF} (u-boat simulator) (256k) {flp) £10.00 


OPEN GOLF (OLIVEA NEEF} [go# simutator) (384k) {fip) £12.50 


PUDGE (DAMON CHAPLIN) (arcade game} (128k) (ilp:mdv) £12.50 


£10.00 


CLIP ART 1 - SPORTS (FLP) £6.00 
CLIP ART 2 - WHIMSIES (FLP) £6.00 
CLIP ART 3 - OFFICE {FLP} £6.00 
CUP ART 4 - VIZ (FLP) £6.00 

CLIP ART 5- GENERAL (FLP} £6.00 


SPEEDSGREEN - ROM VERSION £20.) 
SPEEDSGREEN - FLP/MDY £10 00 
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THE BLAG2 (TONY WOOLCOCK) {text adventure) (256k) [flp‘mdv) £10.00 


HERE WE GO (PHIL JONES AND ANDY CSERBAKO)) (text adventure} (12Bk) (fip’mdv} £10.00 
MACSPORAAN'S LAMENT (QAVE WATSON) {illustrated text adventure) (128K) [fip’mdv} £10.00 


ORBITING STARS (JOHN TOPHAM) (astranormeal simulator) (128/256) (fipmadv) £10.00 
PERSONAL FINANCE MANAGER (JASON VICINANZA)} (budget systermni 112k} (flp:mdy) £10.00 
POLYTEXT {NICK WARD) {multi-column quill) {128/256k} (tip-mdv) £17.50 


QUICK MANOELBAOT (KENNETH MURRAY} ffractals) (128k) (fiprnav) £10.00 

QUICK MANDELBROT & JULIA (KENNETH MUARAY) [fractals} (128k) (fip'*mdv) £12.50 
QUIZMASTER (PHIL JONES AND ANDY CSERBAKOI) (quiz game} (128%) (fip’mdv) €10.00 
QUIZMASTER II {AS ABOVE & RICH MELLOR) {quiz game + module option) (128k) (flp:mdv) £12.50 
RETURN TO EDEN (OLIVER NEEF) {role-playing illustrated adventure) (256k} (tip) £17.50 
SCRIPTWARITER (ANDY PRITCHARD} (text processor) (256k) {fip‘mdy) £15 00 

SECTOR X {HORST SPIERLING) {shaat ‘em up) {256k} (fla) £12.50 {mdv} £15.00 

SPEEDFAEAKS (DAMON CHAPLIN) (car race game) {128k} itpymdv) £12.50 

SQUIDGY ROUND THE WORLD (MICHAEL CROWE) (arcade gamei [flp) £12.50 (may) £15.00 
STARPLOD (ALAN PEMBERTON, (icon-driven adventure) (128k) (fipmadv) £10.00 

30 TERRAIN (JAN THOMPSON) [use abacus data to create 3D qrapns} (128k) (ipymedv) £12.50 
STOOL (ALAN PEMBERTON & AICH MELLOR) ST 2QL} (screen transter & image processor} [256k] {fip/mdvi 


UNCLE LOONIE'S LEGACY (DAVE WATSON} (puzzle adventure} (128k) ({ipmov) £10.00 
VOYAGE OF THE BEANO (ALAN PEMBERTON) [illustrated tex! adventure} (256k) (fip) £12.50 
WRECK DIVE (NICK WARD) (arcade adventure] (128k) ({lpmdy) £10.00 


if you replace these with standard LINE 
commands, but you will need to adjust 
SCALE, XMAX and YMAX to keep the 
image inside the window, as the LINE 
coordinates system does not correspond 
to pixels directly. 

Listing three is a prime candidate for 
multitasking in that it generates a moving 
image that can move over any back- 
ground. Lines 150 to 200, 220 and 590 
are Turbodirectives that ensure top speed, 
and should be missed out if you do not 
own Turbo; compile with 0 windows cop- 
ied, to avoid disturbing the screen whena 
new task loads. 

The program starts by asking for the 
‘Pattern size’, the number of lines to be 
shown at a time. Try any value from one 
to several hundreds. EXEC two or three 
copies of the compiled program, generat- 


Program size 


ing patterns that bounce behind and in 
front of each other. Adjust task priorities, 
window positions and pattern lengths for 
best results, and have fun. 

lf you want to save typing and obtain the 
fast graphics commands and a compiled 
‘kinetic’ task besides, note that programs 
2 and 3 are included in DIY Toolkit Vol- 
ume G, along with other SuperBasic 


C.G.H. SERVICES 


Cwm Gwen Hall, Pencader, Dyfed, Cymru, SA39 9HA (Tel. 0559 384574) (9am - 5pm) 
COMMERCIAL SOFTWARE 


ANELPUM QUAT (NICK WARD) [text adventure) (128k) (tlpymdv) £10.00 
ASSAULT AND BATTERY (OAMON CHAPLIN) (shoot ‘em up) {128k} (flpmdy) £12 50 


DOUBLE BLOCK (FRANCOIS LANGCIAULT) (arcade game} (128k) [fp'mdy} £10 00 

DOREAMLANDS (JEAN-YVES ROUFFIAC) (text adventure} (256k) {fip) £10.00 

EPIC ADVENTURE (ANDY PRITCHARD} (iflustrated adventure) (256k) (flp) £12.50 

FIVE GAMES PACK 1 (WAEFORD DAVIES) {mind games} (*2Bk) {flp) £12.50 

FRACTALS FROM NEWTONS METHOD (JOHN TOPHAM (fractals! (128%) (floymov) £12.50 

FROM THE TOWER OF VALAGON (ALAN PEMBERTON} (text advanture) (128k) (flp/mdv) £10.00 
GEE-GEE SYSTEM (PHIL JONES AND ANDY CSERBAKO)) (race predictor} (128k) (fip’mdv) £10.00 


GAMES DISK 3 (includes OL War| 


GRAPHIX DEMOS DISK 1.3, 4 


ALL PRICE 


PUBLICATIONS 


OL TECHNICAL REVIEW ISSUES 1-2 £1 50 EACH 

OL TECHNICAL REVIEW ISSUES 3-6 £1 75 EACH 

OL ADVENTURERS FORUM ISSUES 1-3 £1.25 EACH 
QL ADVENTURERS FORUM ISSUES 4.9 £1.50 EACH 
OL LEISURE REVIEW ISSUE 1 £1.75 EACH 
INTERNATIONAL OL REPORT ISSUES 1-2 £1.60 EACH 
Qt SURVIVOR'S SOURCE BOOK £2.50 EACH 


PUBLIC DOMAIN AND SHAREWARE LIBRARY 
ALL DISKS £2.00 EACH INCLUSIVE OF MEDIA AND P&P 


ADVENTURE GAMES DISK 4 |includes fantasia and ye classical type adventure! 

ADVENTURE SOLUTION DISKS 1-2 {includes The Pawn and Martwtie Manor, mainty ST thought} 
ADVENTURE SOLUTIONS DISK 4 (QL specific] 

ADVENTURE GAMES SOUAGE COOE DISK 1 ‘includes Fantasia, Haumted House, etc) 
ADVENTURE UTILITIES DISK (includes Quill 1o SuperBasic converter and damo adventure} 
AUSTRALIAN PD. DISKS 7 + 2 Linciudes a wide variely of games, utilities etc) 
COMMUNICATIONS DISK 1 (includes OBOX Bulletin Board system! 

COMMUNICATIONS DISK 2 imotudes QL Kermit) 

CONNECTIONS DISK 1 {includes ST - OL screen and file converters) 

DEVICE UTILITIES DISK 1 {cludes Archiang. compactng. formatting and Shall programs} 
DILWYN JONES DISK + fintiudes many SuperBasic prags and Wordsearch) 

EDITORS DISK 1 (includes QED and MictoEmacs) 

EQUCATIONAL PROGRAMS DISK * [includes maths, music and chemistry programs) 
EMMANUEL VERBEECK DISK 1 }eciudes screen save and print peogs. and many rmiore ulllitias) 
ESOTERICA DISK 1 (includes DIY Pyramid construction prog. Biorythms and Psychology progs! 
FRACTALS DISK 1 [includes large numbers of mandelbral and other fractal progs) 

FRACTALS DISK 2 (Carl Cronin’s mardelbrot prog plus animation screens} 

FRACTALS DISK 3 (Rainer Kowallick’s marndelbrol prog as amended to gwe “Jewel” effect) 
GAMES DISK 1 (includes Starburst, Cavam Frenzy) 

GAMES DISK 2 fincludes many arcade type games| 


GERMAN TO ENGLISH DICTIONARY (rulti-tasking) 
GRAPHIX ANIMATION DISKS 1. 2, 3, 4.5 (TV Movies: 


GRAPHIX SCREENS |FIF FORMAT) DISKS 1,23 

GRAPHIX SCREENS (PIX FORMAT) DISK 1 

GRAPHIX SCREENS (SPECTRUM! DISK 1 

GRAPHIX SCREENS (ST) DISKS 1,2,5,4,5 6,73 

GRAPHICS 'SCREEN UTILITIES DISK 1 fincludes sprite designer. CAD and window progs } 
HAM RADIO DISK 1 (includes PC conversions) 

INDEXES DISK + |nciudes calculator. pi and calendar creator progs.) 

OLIVER FINK DISK 1 [includes progs requiring Pomler environment to work) 

PRINTER UTILITIES DISK 1 (includes label creators and printer tutorials) 

PROGRAMMING DISK ¢ {rnchudes OL PROLOG) 

PROGRAMMING DISKS 2 8 {C68 Compiler} 

RALF BIEDERMANN DISKS 1 + 2 (excellant cofiection of programs. games, utilities. etc.) 
RECREATIONAL MATHS DISK (includes life cellular automatons etc) 

SUPERBASIC UTILITIES DISK 1 Jincludes large numbers of unity progs, toolkits. pronedures etc! 
TEXT DISKS 1-7 (The Bible - Old Testament) 

TEXTDISK 15-16 (The Bible New Testament) 

TEXT DISK 14 [4004 Business Letlers fram U S.A.) 


Please note the above are only part of our P D. Library. New programs are constanily being added and more are always 
welcome. Please send an S.A.E. for tult coage 
‘We can also su pply commercial software for S 
Ss INCLUDE MEOIA AND POST AND PACKING FOR THE UK. 
PLEASE ADD 10% FOR ORDERS IN EUROPE. 20% OUTSIDE OF ELIROPE 
PLEASE INDICATE 3.5"5.25"MD¥ VERSIONS WHEN ORDERING 


graphics programs, PLOT, DRAW, CHAN 
and PIXEL% extensions, documentations 
and source code. The volume costs £7, or 
£20 on disk with five other volumes of 
‘device tools’. Call DIY Toolkit on (0559) 
384574, or write to Cwm Gwen Hall, 
Pencader, Dyfed, Cymru SA39 SHA. 

Sierpinski’s Gasket and many other 
fractals are introduced and simply ex- 
plained in James Gleick’s best-selling 
paperback book Chaos, Making a New 
Science, published by Cardinal, ISBN 0- 
7474-0413-5. Fractal programmers 
should read John De Rivaz’s excellent bi- 
monthly fanzine Fractal Report, which 
often features SuperBasic programs, as 
well as images and algorithms that can be 
translated from other systems. For a free 
copy, send an A4 to Fractal Report, 
West Towan House, Porthtowan, Truro, 
Cornwall TR4 8AX. 

Commercial QL fractal programs are 
supplied by CGH Services, and Progs — 
via Dilwyn Jones in the UK. Quick 
Mandelbrot (£10, 128K+) and Qractal 
(£20, 512K+) explore the intricate and 
infinite Mandelbrot Set. Qractal is de- 
servedly twice the price of its rival, with 
similar resolution but many more fea- 
tures. Both were reviewed in QL World in 
June; a new version of Quick Mandelbrot 
is advertised, adding Julia set displays for 
an extra £2.50. 


$ and Amigas! 
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S$ FTWARE FILE 


hen Digital Precision sug- 

gested that buyers of The 

Editorcould ‘chuck Quiffout’, 

doubts were expressed, but 
that statement can truly be applied now to 
Perfection. Quill simply isn't in the same 
league. As lack of speed has always been 
a major drawback of Quill, Perfection has 
half-won the battle by the time anyone has 
used it for a few minutes. 

Perfection needs at least 256 KB of 
memory; the program itself takes 150 KB 
and loaded files take about as much space 
as they do on disk. It will run on Thors and 
the Atari QL emulator. 

The Back-up routine produces a working 
copy of Perfection. You are advised to use 
the Configurator routine, which is a visu- 
ally attractive, simple and comprehensive 
default-setting program. 

The two Boot files contain REMark lines, 
specifying changes to suit system configu- 
ration. The start-up screen offers the op- 
tions to use Configurator or Create_ 
Printer_Data; if neither are chosen, the 
main program is run. For many users, 
there will be no need to do anything ini- 
tially, as the provided files will be satistac- 
tory. 

Perfection is aimed at Quill users. The 
command menu structure looks similar, 
and the default screen fount is the same, 
so the new user should feel at home. 
Perfection gives you the same screen 
features as Quill: bold, superscript, sub- 
script and underlined text are shown as 
such, and italic text is shown slanted. 

It was inevitable that any successor to 
Quill would differ from it in several ways. 
The Psion program is easy to learn, and 
adequate for small documents, but it be- 
gins to creak when much more than simple 
letters are required of it. Perfection is little 
concerned by the size of document, and 
provides many more functions, including 
several major ones. The obvious functions 
are spelling checking and the combination 
of graphics with text. The spell-checker is 
still being worked on but should be avail- 
able by the time you read this. 

So, what is the answer to the question 
‘does Perfection solve the problems that 
drive Quill users crazy?’ My feeling is that 
users will generally say ‘yes’. It is much 
faster than Quill, handles large documents 
without murmur, and doesn’t throw tan- 
trums and cause your life’s work to be lost; 
the spell-check function will be a ‘natural’ 
extension, some graphics-import capabil- 
ity is provided, most file types can be 
handled (it is good for programmers too), 
and it isn't a memory hog. 
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The beta-tester 
emerges: 

Bryan Davies 
settles down with 
Perfection. 


There are far too many editing com- 
mands for all of them to be mentioned 
here, but some of the important ones fol- 
low. Different-coloured highlight Strips en- 
able printer functions to be called without 
padding the text with visible codes. You 
could use Strips to select different printer 
character pitches. 

Whenever any type attribute is changed, 
it takes effect from the cursor to the end of 
the document; you have to give the ‘off’ 
command to make the remainder of the 
text return to normal. This seems rather 
strange at first, but you get used to it. 
There is a distinct lag before the display 
shows a newly-set attribute, and this lag 
also occurs with such things as the page- 
break line and the page number indicator. 
This does not create any problem. 

Margins and tabs can be reset at any 
time; the effect is on new text only; existing 
text remains unchanged, unless the 
<reformat pAra> or <reformat hEreon> 
commandis used onit. This allows changes 
of format at any point within a document. 
The printer will see changes at the point 
they occur and will not alter the format of 
previous text. Reformatting is not auto- 
matic. After changing the right margin, you 
can go back to previous text and insert or 
delete without line-wrap action being initi- 
ated on the current line unless you extend 
the text out to the right margin previously 
set with the Configurator (if it is larger than 
the new setting). Areformat command can 


INFORMATION: 

Program: Perfection V2.04 

Price: £119.95 with spelling- 
checker, £79.95 without 
Digital Precision Ltd., 222 
The Avenue, Chingford, 
London E4 9SE. Tel: (081) 
527 5493 


Supplier: 


be given for the whole of the current para- 
graph, for the current paragraph from the 
cursor point forwards, or for the remainder 
of the document from the cursor point 
forwards. Itis nota fast process andis best 
left till editing is complete. 

The left margin can be set in both the 
document and the printer data file, and 
there are good reasons to set it in the 
latter. If aleft margin other than 1 is set on- 
screen, and the underline function is used, 
the on-screen margin area will have un- 
derlining in it if the underlined text spans 
two lines; the same happens on the print- 
out currently, but version 2.05 will fix this 
problem. If a change of character pitch is 
made and it spans two lines, the margin 
width will change. Neither of these prob- 
lems occurs when the left margin is set in 
the printer data file. Having no blank space 
at the left of the screen also means that 
more characters can be displayed on a 
line, but it is a pity that the leftmost column 
is then identified as 1 regardless of what 
the actual position will be when the text is 
printed. 

Justification is displayed on-screen. The 
modes offered are flush left, fully justified, 
flush right, and centred. Printouts should 
look essentially as the screen does, as far 
as word spacing is concerned, but right 
justification is not maintained when pro- 
portionally spaced print is used. The <Re- 
instate line> command allows deleted text 
to be put back on the screen, so long as the 

> cursor has not been 
moved off the line 
concerned at all. 
» Search and Re- 
place operations can 
be case-sensitive or 
-insensitive, for- 
wards or backwards. 
The search string 
can be the one used 
in the previous op- 
eration, or a new 
one. The string can 
include attributes, 
such as Empha- 
sised, making it pos- 
sible to replace one 
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attribute by another—eg replace underline 
by bold. The cursor position is the starting 
point for both forward and backward op- 
erations. A separate command permits 
Search or Replace operations to be re- 
peated with existing strings. 

The codes which are sent to the printer 
to indicate changes of attribute are not 
shown on-screen, except when the <hid- 
den Codes> command is used to display 
them. To enter them, you first have to key 
CTRL-£, which is a ‘primer’ character that 
lets the program know the next character 
is ‘special’. You cannot use the same 
keying that indicates the attribute to the 
printer, butthere is a separate listof keyings 
in the manual. Replace can be a one-by- 
one operation <Replace>, or a global 
<Replace (All}>. The latter is always a 
risky mode, and you need to be careful 
when using it with the ‘NQ’ (No Query) 
indicator showing. When this is done in a 
large document the screen remains un- 
changed for quite a long time, if there are 
a lot of replacements to be made; no 
status indication is given. You can use 
ESC to stop the operation. In general, both 
Search and Replace are fast operations. 

Page breaks are important and Perfec- 
tion has two forms. When the page length 
is set, through the Configurator or during 
creation/editing of a document, the pro- 
gram displays a red line underneath the 
set line (soft page break). This is non- 
deletable. The user can place a hard page 
break wherever one is required, and it is 
displayed as a row of black + signs ona 
white background. This canbe deleted. The 
page length can be reset at any time and 
the new setting takes effect on the whole 
document immediately. 


Flexible format 


Headers and footers can be created, as 
in Quill, but with a more flexible format. 
The limitation on size is high enough for 
anything on A4 paper, typestyle attributes 
can be used, and page numbers can be 
set to be printed automatically at desired 
positions and in various formats. The nor- 
mal editing window is used to set up 
headers and footers, but they are not 
displayed during normal editing. Page 
breaks are positioned to allow for header 
and footer. 

Two windows, vertically positioned and 
adjustable in height, can be used to dis- 
play different parts of the same document. 
Navigation of the cursor between them is 
by pressing F5. Once in a window, you can 
move the cursor to any pointin the file and 
perform any editing commands. A change 
in one window won't necessarily be re- 
flected in the other, until you move back to 
it. Text can be copied or moved from one 
window to the other (from one part of the 
document to another) —a very handy func- 
tion. 

Eight markers are available to be set 
anywhere in a document. Movement to 
markers is fast. The set-marker keying in 
the manual is printed as SHIFT-ALT-1 to 


8, but ALT-SHIFT-1 to 8 was required on 
my system. 

Perfection seems relatively oblivious of 
document size, and the limit is 2MB! You 
need high-density drives to be able to save 
files larger than about 700 KB. 

Settings which DP has set as defaults 
are not displayed. For example, full justifi- 
cation is the mode as supplied, but there is 
nothing on the status line to show that. If 
you subsequently use the <Justification> 
command, it cycles to the next mode each 
time you use it, and the mode will be 
indicated on the status line; ‘CJ’ for cen- 
tred, ‘RJ’ for flush right, etc. Two-character 
status displays for eleven functions in all 
appear whenever appropriate. ‘CAPS’ is 
displayed if the CAPS LOCK is on. Perma- 
nent indication is given of the cursor col- 
umn number, the line number (within the 
document), the total number of lines in the 
document, the number of the current page 
(revised to reflect any page numbering 
change set by the user), and the character 
code of the cursor character. 


Status lines 


There is an alternative status line, which 
shows the number of characters in the 
document, total number of words, total 
pages and the number of the line within the 
current page. The average user would 
perhaps think the last one of these ought 
to be on the default status line. The alter- 
nate status line is replaced by the usual 
one when the cursor is moved. Messages 
overwrite (temporarily) the status line indi- 
cators. The manual lists four pages of 
messages, with brief explanations of pos- 
sible reasons for them. 

The Load command is an all-purpose 
one. You can load Quill_Doc files, 
SuperBasic program files, Ascii-formattext 
tiles, and Psion Export files, as well as 
Perfection’s files. Even corrupted files 
should be loadable, up to the point where 
the corruption occurs; _Doc files load in 
surprisingly good shape, looking much as 
they do in Quill. Settings such as margins, 
justification and tabs are removed from the 
incoming file, as are headers and footers. 
It is suggested that any text files in alien 
format are flush-left justified before load- 
ing into Perfection. Returning a file to its 
original format is a question of setting the 
same values after loading, the using the 
Reformat command. 


Merge command 


There is a Merge command, to allow 
additional files to be added to any point 
within a current one. This is intended for 
Ascii-format files only, not for Perfection’s 
files, Quill files etc. You can Merge such 
files, but all their formatting codes come 
with them. Files from The Editor can be 
loaded this way. The basic Save command 
creates Perfection-formatfiles, regardless 
of the file format when loaded. The full 36 
characters that Qdos accepts are allow- 
able in file names. Confirmation is re- 
quested if a Save is initiated with an exist- 


ing file name. To save a document without 
the program’s own format information, 
there is the <Export file> command. This 
creates a file suitable for import into other 
programs. It can also be used with 
SuperBasic programs, with the reserva- 
tion (not made in the manual) that (line 
Wrap) needs to be switched off if editing of 
the SB file involves use of the ENTER key 
(program lines get concatenated and cor- 
rupted by the ENTER codes otherwise). 

One thing the user might miss is the 
ability to do housekeeping from within the 
program. Unlike Quill, there is no directory 
function and no format, delete or back-up. 
You can use CTRL-C to return (temporar- 
ily) to SB and perform file operations. 

Perfection has a dual-command struc- 
ture, one access method being via Quill- 
like menus and the F3 key, the other more 
for the ‘hacker’, with the CTRL, ALT and 
SHIFT keys being used in combination 
with other keys. Both methods are avail- 
able to users all the time, the theory being 
that confirmed Quill-users will prefer the 
F3-plus-menu approach, and programming 
types will use the other one, but neither 
category of user is denied the option to use 
the other’s approach. Some of the key 
combinations are rather daunting, although 
keyings for frequently-used commands 
such as Go To Bottom (CTRL-B) are eas- 
ily memorised. They are much quicker 
than the menus are. 

The multiplicity of functions requires a 
multi-level menu structure, and you may 
have to press F3 as many as three times, 
then some other keys, to get what you 
need. Users of the ALTKEY function will 
be pleased to know that most of the two- 
key combinations using ALT have been 
left alone, for use with existing macros. 


Await index 

F1 calls-up the help screen, and several 
text-editing commands can be used within 
the help pages. The Search function works, 
as do the macro cursor movementkeyings. 
There is a README file on the supplied 
disk which acts as a tutorial for Perfection 
features. 

The manual has 104 sides of detailed 
information. There is no index yet but there 
is a glossary of many of the terms (eg 
Pseudo Space). The manual is well-writ- 
ten and covers most topics adequately, 
although more detail would help on some 
unfamiliar subjects. 

The sluggish cursor drives many heavy 
users away from Quill. Perfection over- 
comes the sluggish response by using the 
lazy-screen technique; only one line of the 
screen is repainted when the up/down 
cursor key is used, rather than the entire 
screen (as with Quill). The lazy screen 
works so well that one can scroll through 
text faster than on an average PC. The 
penalty is that users may not like the 
screen presentation, during cursor move- 
ment only. Many users will be happy to 
work with itin ‘Quill mode’; itis fast enough 
this way. 


Sineclair/QL World December 1991 


Perfection is not designed to cope with 
size changes on-screen, but the Strip 
functions can be used to mark areas which 
are to be printed in different founts. The 
program will not know anything about the 
sizes of yourfounts and you will have to do 
your own calculations and use the EN- 
TER key to shorten lines, or make trial 
prints, to ensure that line lengths and 
margins are correct. 

Images can be inserted between text 
lines, which is a very advanced feature. 
The onus is on the user to get the image 
in the right place and of the right size. 
Images (of any size) saved to a file from 
Professional Publisher can be inserted 
into Perfection documents. The mecha- 
nism is to type text up to the line above 
where an image is required, then insert 
the command the program needs to see 
to look for a graphics file. You must leave 
sufficient blank lines between text to make 
room for the image. 


Graphics insert 


To get the graphics file inserted, the 
routine Propub Inserter must be running 
when the text file is printed. The printer 
driver encounters the code indicating a 
graphics file is to be inserted and auto- 
matically passes the name of the required 
file to the inserter program. The image is 
printed where the calling code and file 
name were entered. Once the image has 
been printed, control is returned to the 
printer driver to continue printing text. 

Perfection will give printout ‘out of the 
box’, but DP provides a separate program 
to create or modify printer-drivers. It is 
easy to use, considerable effort having 
been expended to assist the inexperi- 
enceduser in the matter of entering printer 
codes. This program allows entry in any of 
the usual formats (hex, decimal, Ascii) or 
a mixture of them. The entries for the 
supplied driver give sufficient clues as to 
how itis done. My problem lay in the usual 


area — page length. No choice of length 
with Perfection’s <Quote page length> 
command would make the printer move to 


the tops of pages. The answer lay in 
inserting the codes for line spacing and 
lines per page in the Preamble of the 
printer-driver file; I've not had to do this 
before. 

The driver creation program allows up to 
16 Translate entries. This will suffice for 
most users but could be a minor irritant for 
those who use ‘foreign’ characters. There 
are also settings for four Strips, which 
appear as different highlight colours on- 
screen. Three of these can represent dif- 
ferent printer pitches, the fourth being an 
‘off’ switch for the others. When coming 
straight from Quill, there is an easy option 
— convert your existing Quill Printer Data- 
file into a Perfection Printer Data file. This 
is done automatically when the appropri- 
ate option is selected. You give the file 
name and location of the Quill file, then 
save it as a Perfection file. Straightfor- 
ward and quite painless. 

Headers and footers can be printed. To 
change them for opposing pages, you 
print all even pages first, then all odd ones 
(or vice-versa) as a separate run. The 
number of the first page can be changed 
(to 0 for instance); this is a global, one- 
time change and you cannot subsequently 
renumber another group of pages. 

After modifying the supplied 
Printer_Data file to match an existing Quill 
file, successful printouts were made from 
a Kaga-Taxan 9-pin DMP and Epson GQ- 
5000 laser printer (in FX80-emulation 
mode). Trouble was experienced printing 
images, and it was associated with the 
code string &27, &73, &1 (decimal) in the 
Printer data Preamble. It is suggested you 
don't use this. 

A macro can be called from a file when 
the program is started up, and another 
can be called from a memory buffer when 
the program is running. This is an appro- 
priate way of entering prepared text into a 
document. The required text must be 
present in the document, or ina file. You 
can mark a text block and copy it into the 
macro buffer, or load a text file into the 
buffer. The text can be inserted from the 
buffer into the document, at the current 

moe Cursor position. 
Experimenting with this func- 
tion suggested that it is better to 
keep required blocks of text in 
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files and use the Load or Merge com- 
mands. The macro operation did not al- 
ways position text where it was required, 
nor did it always produce all the text from 
the buffer. It was also slower than loading 
a file containing the same text. The func- 
tion needs developing. 

Stripsort removes or changes codes 
and (optionally) sorts lines into sequence. 
To make Saved or Exported files compat- 
ible with other programs, codes for page 
breaks and end of paragraph can be 
changed to line feeds. Typestyle attribute 
codes and ‘pseudo spaces’ (which Per- 
fection inserts to justify lines) can be re- 
moved. If you know what codes the target 
program uses for functions such as un- 
derlining, you can translate the Perfection 
equivalents into the required ones or ex- 
change them for text strings which can be 
used as bases for search-and-replace 
operations in the target program. 


Much faster 


While you might, initially, load Quill files 
for the purpose of converting them to 
Perfection format, you would thereafter 
be creating files in Perfection and would 
benefit by having a/! operations per- 
formed substantially faster. As a rough 
guide, if you create a substantial docu- 
ment in Perfection which is equivalent—in 
terms of how it will print out — to one 
created in Quill, and you use the Very 
Lazy screen feature, the speed of naviga- 
tion and block commands (eg Copy) should 
be about four to seven times greater. File 
loading and saving will be faster too. A 
Gold Card increases speed by a further 
three to five times. 

As auser who doesn't touch Quill uniess 
forced to, there was never any need to 
convince me to buy a program to replace 
it. The Editor was the first such program, 
and text was the next. Both caused a fair 
number of headaches, but were worth the 
effort. Those who are still using Quill, but 
are suffering from doing so, should give 
serious thought to buying Perfection; the 
speed and flexibility would come as a 
breath of fresh air. Some readers may be 
surprised not to find benchmarks in this 
review. My feeling is that they would be a 
waste of space; the programs is much 
faster than one it is de- 
signed to replace. It is 
also better in nearly all 
other respects. The in- 
tention is to add sev- 
eral features in future 
upgrades of Perfec- 
tion, so the buyer now 
can have confidence 
that the program will 
become steadily more 
satisfactory as time 
goes by. Starting from 
the high, basic specifi- 
cation of the first re- 
lease, you can't go far 
s wrong. 
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Questionaire 
Update 


Dr. Sohail Bhatti 
reports that the 
QLAW 
questionaire has 
now exceeded 
expertations and 
the analysis is 
proceeding. 


ccording to Chaos Theory, the flap 

of a butterfly’s wing in the Amazon 

can, through a series of random 

but interdependent events, lead 

to a typhoon in the South China seas. In 
the same way small but significant events 
have led to the creation of QLAW and its 
questionnaire. Since last writing there has 
been a slow but steady stream of re- 
sponses with around 10% of all QL users 
now having taken the time and trouble to 
fill and send it, in all of its guises. | had 
expected that there would be a flurry of 
activity following publication but to my 
surprise there were around six to twelve 
replies per day over some months. Per- 
haps it would be more helpful if the back- 
ground of the questionnaire is explained. 


Plug-ins 


It all, began at the end of 1990. | had 
been aware for a number of years that 
| there were people working on various plug- 
in enhancements. Like most such projects 
only a small proportion would reach com- 
pletion. However, for some time no-one 
(except Miracle) had brought out anything 
new. Coincidentally, | was looking to im- 
prove my computing environment. | had a 
number of choices. Leaving aside ail the 
different facilities on offer, the main prob- 
lem was that | would have to purchase a 
(very expensive) portfolio of software to 
match my needs. These needs were being 
almost wholly met by my QL, but | foresaw 
that this might not always be the case. 
Like many people | have access to a PC 
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at work and, while | was impressed with 
the depth and quality of software avail- 
able, MS—dos itself | found a difficult oper- 
ating system. With the advent of Window 
3, the user interface is much prettier and 
less threatening than the dreaded C:\ 
prompt of MS-DOS. Unfortunately, to run 
the system properly requires a hefty in- 
vestment in processors, memory, mice, 
VGA display and monitor. Even with to- 
day's heavy discounting the outlay for 
hardware would easily top £1200. One 
reason for this is that on a PC (and to a 
large extent the Apple Macintosh) a hard 
disc is nota luxury, itis an absolute neces- 
sity. For example, around 10 Mbytes of 
hard disk is taken up by Windows and you 
also need a minimum of 2Mbytes of ram on 
board to make it work effectively. Much the 
same is true of the System 7 operating 
system brought out by Apple for the Mac- 
intosh. This would only be the initial outlay. 
| would have to pay the same amount 
again to get the software that makes these 
machines so attractive. Then, as anovice, 
| would have to invest hundreds of hours in 
learning the new operating system and 
also on the new programs. Of course, | 
could do what so many others do...borrow 
the software | have access to at work —but 
that would be stealing, wouldn't it? 
There were other alternatives: the Amiga 
and the Atari ST. Both have QL emulators. 
In the case of the Amiga this is cheap but 
idiosyncratic. The ST does have potential 
but the use made of the hardware and the 
loss of compatibility with eprom boards, 
etc., is | feel not sufficient justification for 


the outlay required — particularly now that | 
3.2 Mbyte floppy drives are available to 
Gold Card owners. The only alternative for 
me, | felt, was to encourage the comple- 
tion and development of QL-specific pe- 
ripherals. 

Having decided to stick with the QL, and 
not having the necessary experience and 
expertise, | decided that | would ‘donate’ 
the task to the user group, Quanta. Unfor- 
tunately, despite much correspondence, 
there was insufficient interest in mounting 
sucha potentially large venture. This meant 
that the task would fall onto individuals. In 
an effort to identify people who would have 
the necessary design expertise in elec- 
tronics | contacted the then Quanta mem- 
bership secretary with a request that he 
query his database of some 2,000 mem- 
bers and fish out the names. While there 
had been an attempt to form a detailed 
profile on each Quanta member a few 
years ago, it seemed that the database 
was not sufficiently detailed no up-to-date. 
Out of this chain of events, the idea of a 
questionnaire was. born. 


Skills and goal 


The initial concept was to identify people 
who had both hardware and/or software 
skills. This would allow the creation of a 
team working toward a common goal. It 
immediately became obvious that the ef- 
fort involved could also be used to provide 
more detailed information on the ‘average’ 
QL user. Anyone still using a machine 
conventionally ‘dead’ for 4-5 years would 
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certainly be someone out of the ordinary. 
Thus the questionnaire began to grow. Itis 
divided into four sections. The first section 
establishes important features on the re- 
spondent such as age, occupation, geo- 
graphical location and income. It is with 
this information that the rest of the ques- 
tionnaire will be correlated. Unfortunately, 
the design of the the question on occupa- 
tion masked the important section asking 
the actual title of the job. 

The next section then attempts to dis- 
cover the outlay that this person has made 
in hardware terms. It also gives informa- 
tion on what roms and other QL- 
compatibles are in circulation and how the 
user has dealt with the problems of expan- 
sion and reliability. There is also a section 
asking how many local QL users the re- 
spondent knows. It might therefore be 
possible to establish whether isolated us- 
ers are more or less likely to invest in their 
machines. Furthermore, the geographical 
spread might allow the creation of local 
support groups. 


Interest group 


In fact, information already examined 
suggests that there would sufficient num- 
bers for a Greater Manchester interest 
group to be set up. Using the Quanta 
membership as a base, a group called 
QUM (Qdos Users of Manchester) has 
now been meeting for three months, regu- 
larly at 7pm on the third Tuesday of the 
month at Manchester University, St Pe- 
ter's House, Precinct Centre, Oxford Road, 
next to the Maths Tower. | believe that 
there are over 150 Quanta members in the 
areas of Halifax and Huddersfield, Greater 
Manchester, Stockport and Lancashire. 
Further details can be obtained from the 
QUM secretary Mike Kenneally, 6 Barnaby 
Road, Poynton, Cheshire SK12 1LR. 

The next section of the questionnaire 
attempts to gauge the interests and use of 
the machine by the QL user. These might 

| be the same but if there is a need for a 
particular interest to be met then perhaps 
someone may be persuaded to write a 
program addressing that need. Italso asks 
about what hardware items they would 
like, in order to enhance the performance 
of the current set-up as well as what ma- 
chine they would feel would most fulfil their 
future needs. This is perhaps the section 
most likely to cause problems of bias in 
that it may be only people who wish to 
encourage the creation of a ‘SuperQL’ 
who have bothered to reply | say this 
because the overwhelming majority of re- 
spondents (around four-fifths) have indi- 
cated that they prefer a QL development 
rather than the selection of machines of- 
fered. Obviously, this represents a tre- 
mendous collective need which may be 
somewhat modified when specifics are 
mentioned. This has been brought out in 
many letters sent with the questionnaires 
where people have offered investment 
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loans, facilities, programs and hardware 
designs as well as their most valuable 
asset, time, all to help develop a modern 
QL successor. This is one tangible result 
of the questionnaire in that it has brought 
into the open the desire and need for such 
a project. In the long time this usually 
requires an ‘open’ architecture following 
QDOS standards, perhaps using a 68020 
processor to give a ten-fold performance 
improvement over the QL. Unfortunately, 
the patience of current users is the meas- 
ure of whether such ventures will be 
successful or not. 


Software deductions 


The last section of the QLAW portion of 
the questionnaire establishes the familiar- 
ity people have with certain programs. The 
selection reflects my own particular bias, 
but it does give a spread of new and old 
programs. It also gives an indication of the 
average strengths and weaknesses of 
users as well as acting as an internal 
check on the previous section. | hope that 
with the software houses’ co-operation 
information on the number of programs in 
circulation will allow me to establish what 
proportion of active users actually re- 
sponded. If this is carried over both a 
number of popular and limited interest 
programs it should provide quiet an accu- 
rate figure. The last section is specific only 
to QL World and deals both with specific 
magazine issues as well as satisfaction 
with Quanta and QL Technical Review, an 
occasional publication of CGH Services. 
This will hopefully allow me to estimate 
how many Quanta members decided to 
reply through Quanta rather than QL World. 
This is important in that it will be affected 
by how often and when the person saw the 
questionnaire. This brings me onto how 
the questionnaire was disseminated. 


Validation 


Original validation — that is establishing 
whether the questionnaire is actually ask- 
ing the questions it thinks it is— was carried 
out by circulating to local sub-groups in 
Chorley as well as QUM. Further copies 
were sent out to the dozen or so Quanta 
sub-groups in the UK listed in the maga- 
zine. This preliminary work was done and 
the 12th version accepted as the final one. 
Copies, were then sent to every group 
listed in the QL Resource Guide, pub- 
lished by the Seacoast Users Group in the 
US. This meant that eventually every user 
group (I hope) in Europe, USA, Australia 
and the UK had seen the questionnaire 
before any magazine published it. The 
response to this was minimal and ques- 
tioning despite the covering letter. QL Tech- 
nical Review then produced an insert with 
the covering letter and questionnaire. This 
has a circulation of over 300 and brought 
quite an encouraging response. Quanta 


were to be the next publishers but delay 
meant that the July issue of QL World was 
actually next. This was unusual in that it 
had the QL World-specific page but it also 
has the widest circulation. The following 
month Quanta also produced the ques- 
tionnaire in the centre pages but with little 
covering information about the project. 
Relative to the 2000 members of that 
organisation a disappointingly small pro- 
portion have responded and this might 
reflect the lack of accompanying informa- 
tion. Then Quasar, the German group with 
around 1000 members also published it in 
English. | have not seen the issue in ques- 
tion and do not know how detailed the 
covering note if any, was. Other groups 
that have published the questionnaire (for 
which | extend my gratitude) include the 
QL International Review (Seacoast users 
Group), Quasar (Dutch users group), the 
Danish, Swedish, Australian, Spanish and 
Scottish QL Users group amongst others, 

As the questionnaires began arriving | 
wrote to each respondent outlining future 
plans, giving general information, recruit- 
ing ‘experts’ and requesting follow-up in- 
formation. The latter action was neces- 
sary because often a question would be 
unanswered or be unclear: a case in point 
was ‘job title’, or whether the world-proc- 
essor used was Quill or Turboquill+. In 
about 20% of cases second letters were 
sent confirming membership of QLAW. If, 
though some administrative oversight, 
someone has not received a confirmatory 
letter then please let me know by writing to 
me at the usual address: 4 Wasdale Av- 
enue, Park View, Blackburn BB1 1D. 
Fortunately, the number of people who 
have withheld their names and addresses 
has been small. | would urge anyone think- 
ing of doing so to please enter the town or 
post code they reside at to at least give an 
idea of their geographical location. | would 
also like to urge those who have still not 
sent in their questionnaire to please think 
again and fill it in now! You can always get 
further copies from either myself at the 
above address or by writing to the Editor at 
QL World, enclosing astamped addressed 
envelope. 


Six per hour 


| hope that this has given you some idea 
of the time and effort involved in putting 
this project together and also its humble 
beginnings. There is no doubt that without 
the support of the many others who have 
joined in with enthusiasm this project would 
have floundered long ago. At this moment 
in time around one quarter of the database 
has been entered into the computer (ata 
rate of six questionnaires per hour). Al- 
ready the butterfly’s wings have caused a 
considerable commotion in the atmos- 
phere. Knowing about developments 
QLAW is encouraging, | can tell you that 
the typhoon is yet to come. Watch this 
space. 
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Predict you future cash flow with 
Peter Tomlin's simple Abacus 


routine. 


ncreasing expenses are 
Ts: into everybody’s 
pay-cheque. It can often 
be a difficulty to see how 
to make ends meet. The Cash 
Flow Chart helps you see into 
the future in respect of how 
your financial standing will be 


{in hand 01/01/91) 
Groceries 


£1087.57 
£ 


inthe weeks or months tocome 
in the year ahead, 

This program for Abacus is 
very easy to set upand useand 
can be useful in making such 
difficult decisions as to how 
much might beallowed for that 
holiday this year or, alterna- 


Saturday 


tively, when belts should be 
tightened. Weekly balances 
reflect the position of one’s 
bank balance at weekends. 

I run two fanfold pages at a 
timestretching ahead about six 
months. The program can be 
updated and lengthened eas- 
ily. One should have access to 
data from the previous year in 
order not to miss out regular 
charges and income, as and 
when they become due. Most 
people will possess this data. 

Variable items like Groceries, 
Gas, Electricity, Phonebills, etc. 
will haveto be estimated. Texts 
which recur, such as “Grocer- 
ies”, can be entered by typing 
the cell reference of their first 
entry into the new cells. 

The line of plus-signs against 
each balance draws the eye to 
the good and bad weeks when 
printed out. As an example, it 
isobvious from Figure one that 
in week ending 12 Jan one 
might be tempted, in view of 
the larger balance seen there, 
to overspend or to tuck a little 
money away on deposit, so 
leading one to go overdrawn 
on the weekend of the 09 Feb, 
Using the Chart forewarns this. 

Asterisks or colons can be 


fo 00/0 
1 


used, instead of plus-signs, of 
course. It is a matter of prefer- 
ence, but when printing, how- 
ever, it must be borne in mind 
that the range offered by Aba- 
cus inthecommand line might 
be a column short, as it reads 
only to the column in which 
the string of characters start 
and not the column in which it 
finishes. With regard to Figure 
one, for instance, the range 
suggested by Abacus for print- 
ing here would be A1:E32, 
whereas A1:F32 was actually 
required, the end of the longest 
string being in column F. 


Functions 


The functions, as set out in 
Figure two, need only the 
briefest explanation, as they are 
all contained in the User Guide. 
The print code in cell A1 is for 
condensed printing, suitable 
for printing onto Filofax-style 
pages. If your Printer can han- 
dle Abacus output, it will han- 
dle this. 

The “rept” functions in col- 
umn E divide the figure in 
column B by 100, in order to 
obtain a manageable string of 
plus signs arising incolumn E. 


£062.57 
£1204,90 
£-350.00 


05 Jan +++tettete rept("+",B5/100} 
Pay-Cheque 
Mortgage 
Cash 


Groceries 
Electricity 


£1792.47 
£-27.06 
£-45.00 
£-582.00 
£1078.47 
£-312.60 
£-30.00 


12 Jan tettttetetetereet rept("+" B12 /100) 
Groceries 
Phone 


Insurance Prems 


Groceries 
Phone 


Insurance Prems 


sum(B12:816} 
Ser Chg & Grnd Rent 
Groceries 


19 Jan +++++++444 rept("+",B17 /100) 
Ser Chg & Grad Rent 
Groceries 


sum(B17:B20) 


26 Jan ++44444 


rept("+" B2 1/100) 


Groceries 
Cash 
Club Subsor 


Groceries 
Cash 
Club Subsor 
09 Feb +4 rept("+”, B26/100) 
Pay-cheque 
Mortgage 
Groceries 
TY Licence 


Pay-cheque 
Mortgage 
Groceries 
TY Licence 
£991.37 sum{B26:B31}_ rept("+",B32/100) 


1 Feb 444444444 


The Program in operation. Fig. | The Functions 
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SOFTWARE FILE 


cated to PC Conqueror, to run 
MS-DOS. 

As far as the backup pro- 
gram could see, this whole 
area of storage was just one 
file, and it asked for another 
disk to put it on. Not surpris- 
ingly, I didn’t have a 15 MB 
floppy tohand (disksofaround 
this size are said to be available 
for about £30, but not from my 
local shop!), which meant that 
the backup had to be aborted 
by resetting the QL, but that 
didn’t affect the files already 
backed up. 

This problem can’t be side- 
stepped by specifying the MS- 
DOS partition as a sub-direc- 
tory that should not bebacked 
up, since the whole partition 
is treated as just one file, nota 
sub-directory. If all “normal” 
filescome beforeit onthe disk, 
there will not bea problem back- 
ing them up, but any that come 
after it can’t be processed. The 
effect is basically the same if a 
normal QDOS file is larger than 
717 KB, which is possible when 
you use hard disk as the ‘save’ 
medium for a word-processing 
| program, for example. 

Many users will not have 


had occasion to read-up on the 
details of archiving and date- 
stamping files. Fortunately, the 
instructions deal with some of 
theimportant points. The screen 
which shows the progress of a 
backup displays FILE LAST 
UPDATED and FILE LAST AR- 
CHIVED. The former is followed 
by the date on which the current 
file was last modified, and the 
date is taken from the system 
clock at the time of modification 
of the file; if you failed to set the 
system clock correctly, the date 
will be incorrect. WinBack is not 
to know whether or not you 
bother to set the clock each time 
you start the QL. It has to assume 
the date it finds is correct. 

The ARCHIVED date is the 
date on which a file was last 
backed by the WinBack. This 
date also will be wrong if you 
failed to set the clock before 
doing the backup. It is quite 
possiblethat the update date will 
show as later than the archive 
date when the reverse is true, if 
you have failed to set the clock 
at the appropriate times. You 
could find all files being backed 
upevery time, even though none 
actually need it. Make sure you 


set the OL clock — every time! 

In general, users are likely to 
be satisfied with the program’s 
decision to back up only those 
files which have been updated 
since the last backup. Hopefully, 
future developments of the 
program will give the user more 
freedom to choose, such as al- 
lowing any files to be specified 
for backup, regardless of when 
they were last backed up. It is 
also desirable to be able to 
specify groups of files; as it 
stands, program files are backed 
up as well as data ones and the 
user may wish to keep thesetwo 
categories separate from each 
other. (You may keep them in 
separate sub-directories, however, 
in which case there should be no 

lem.) 

When the time comes to copy 
a file back to the hard disk, you 
may appreciate having made a 
printout during the backup, be- 
cause it can be rather a pain to 
have to insert disk after disk and 
doDIRs simply to find out which 
diskan odd fileis on. As the files 
are not compressed, or other- 
wise tampered with, the COPY 
or WCOPY commands will re- 
trieve the required file(s) with- 


out bother. 

If] seem not to havesaid much 
about this program, that should 
be taken asa compliment to it. If | _ 
does what it sets out to do, and 
the user does not have to be 
particularly smart to use it. The 
price is reasonable, The instruc- 
tions are clearly-printed (no 
bother with printing-outa_DOC 
file, other than = any 
UPDATES_DOC) and user- 
friendly. The type and manner 
of the backup will be quite sat- 
isfactory for most users. Future 
developments should cater bet- 
ter for the more-demanding 
user, but the program in its 
present form should, at the least, 
ensure that the big disasters 
(often) associated with hard disk 
usage are avoided. As men- 
tioned in the instructions, it is 
nota question of whether you will 
have file problems — just when. 
Most times, you will have cre- 
ated the problem yourself 
(which is no consolation). It is 
most reassuring to know you 
have a spare, up-to-date, set of 
files ready for copying back onto 
the hard disk. 


o ¥é TEM - pie Systemerweiterung flr Ihren ausgebauten QL oder Atari-QL. Nun gibt es endlich 


Systemattribute fiir Floppy- oder Winchesterlaufwerk, d.h., einzeine Files konnen schreibgeschutzt werden, 
unisichtbar werden (Hidden-Files) oder einem bestimmten User zugeordnet werden. Ein evt!. vorhandener 


Schreibschutz von Disketten kann augetren werden. SYSTEM 
Winchestercontrolern und im Netzwerkbetrieb. 


funktioniert mit allen Floppy- 
YSTEM ist DIE ideale Erganzung zum Toolkit Il von Tony Tebby 


oder 


durch ASTAT, ADIR (alphabetisches. Directory), und einer Vielzahl weiterer nitzlicher Befehle. Mit ausfuhrlicher 
gedruckter Anleitung. NEUERSCHEINUNG! 


SYSTEM deutsch (Best.—Nr. 250330) oder englisch (Best.—Nr. 25331) DM 99/233 


QDesign — Das erste Grafikprogramm, das vollstandig unter dem Wman (QJUMP) lauft und mit dem 


Standard Config (QJUMP) konfigurierbar ist. Mitgellefert werden das Pointer Environment (QJUMP und die 
Menterweiterung (Merz). QDesign arbeitet u.a. auch mit Vektorfonts. Umfangreiche Blockoperationen wie das 
Verkleinern, VergroBern, Spiegein, Rotieren usw. machen QDesign zum nitzlichen Werkzeug fur die Bearbeitung 
von Grafiken verschiedenster Art. Pattern liegen im QJUMP Standardformat vor — dadurch kann jeder Sprite auch 
als Pattern verwendet werden. Eine Zoomfunktion ermdglicht eine gute Arbeit an Details. @Design beinhaltet einen 
universellen Druckertreiber fiir 9-, 18— un d 24—Nadel—Drucker. Prof. Publisher— und Atari— Screens kénnen direkt 
geladen, bearbeitet und gesichert werden. Die max. Aufldsung betragt 3200*4800 Pixel. Der Atari-QL wird auch 
im extended Mode unterstitzt und kann dann die gesamte Breite des Bildschirmes nutzen. QDesign ist auch als 
Laserdrucker—Version erhaltlich (fur HP LaserJet, DeskJet, InkJet und Kompatible). Zusatzlich werden in dieser 
Version auch die Nadeldrucker unterstitzt. QDesign ist ein QL—Grafikprogramm, zu dem es keine Alternative gibt. 


QDesign deutsch (Best.—Nr. 250005) oder englisch (Best.—Nr. 250014) DM 111/£37 


QDesign Laser deutsch (Best.-Nr. 250015) oder englisch (Best.-Nr. 250016) DM 129/£43 


QL-—SOFTWARE & QL—-HARDWARE: ORDER OUR FREE OF CHARGE ENGL. PRICE-LIST! 
QL—SOFTWARE UND QL—-HARDWARE: FORDEN SIE UNSERE KOSTENLOSE PREISLISTE AN! 


Export: Preise excl. VAT; Versandskostenpauschale DM 10,—/ £3.30 bei Vorkasse 
durch Verrechnungsscheck. 


Ingenieurbtro Wilfried Krummrey, Postfach 47 04 41, D-1000 Berlin, Germany 
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DBQL 


DBQL 


In part 5, Tom 
Ashcroft begins to 
customise this 
database. 


Listing 1. 


Member _dbf Photos_dbf 


Title Title 


2. Forename Type 

3. Surname Competn 
4, Addressl Points 
5. Address2 Membrnum 


6. Address3 
7. Postcode 
8. Phone 

9, Datejoin 
10. Membrnumn 
ll. Printpts 
Slidepts 


Listing 2, 


100 start 
110 af$="member dbf": ]lload 
120 use 2 

130 bf$="photos_dbf":lload 
140 BORDER 1,7 

150 REPeat menu2 


230 PRINT\TO 27;"7. Exit to DBQL" 


ready? ":PAPER O:INK 7 
250 REPeat. check 
260 com$=INKEY$(~1) 


280 END REPeat check 
290 com=com$ 

300 SELect ON com 

310  =l:use l:en 

320 =2:use 2:en 

330 =3:printout_comp 
340 =4:update_score 
350 =5:comp_place 


370 =7:EXIT menud 
380 END SELect 


400 END REPeat menu2 
410 CLS:menu 

420 STOP 

1000 : 

1130 : 


42 


160 CLS:CLS#4:AT 1,32: PRINT"Camera Club": PRINT 
170 PRINT\TO 27;"1, Enter new member" 

180 PRINT\TO 27;"2. Enter new pictures" 

190 PRINT\TO 27;"3. Competition results" 

200 PRINT\TO 27;"4, Update scores" 

210 PRINT\TO 27;"5, Competition placings" 

220 PRINT\TO 27;"6. Set or Cancel Printer" 


240 IF lprint THEN PRINT\TO 27;:PAPER 7:INK 0: PRINT” Is the printer 


270 IF com$ INSTR "1234567" THEN EXIT check 


360 =6:iprintsl-lprint: next menu2 


390 AT 19,25:PRINT “Press any key to continue": PAUSE 


ofar, the procedures of DBQL have 

been intended to be used with any 
database in an interactive way, but 

itis often useful to adapt the data- 

base program to the needs of a particular 
file, say by the use of special screen lay- 
outs for entering data or for display pur- 
poses. Taking this approach a step fur- 
ther, database users often write a program 
which takes over all the running of the 
database and presents the user with its 
own screens and menus so that the person 
at the keyboard can use the files without 
any knowledge of what is happening inside. 
Many commercial packages, for exam- 
ple Archive or the dBase series, have their 
own programming language for this pur- 
pose built into the database package, and 
programs written in the Archive language 
have been published from time to time in 
Sinclair QL World. These ‘house’ lan- 
guages are usually interpretative, like 
SuperBasic, that is, they have an inter- 
preter program which takes the commands 


of the user program one by one as it runs 
and translates them into the machine code 
instructions required by the microproces- 
sor. Some companies have marketed 
compilers for use with the more popular 
packages such as the dBase series, partly 
for speed of execution and partly for copy- 
right reasons. Users of DBQL already have 
a powerful programming language, 
Superbasic, at their disposal and compil- 
ers are also available. 

To exploit these possibilities it is neces- 
sary to have some knowledge of 
Superbasic programming but there is no 
need to be an ‘expert’ and readers who 
have followed this series in detail so far 
should certainly have ago. This article can 
only give examples of what might be done 
as each application has its own require- 
ments. 

The key to automating or customising 
DBQL files is the use of the SuperBasic 
MERGE and MRUN commands, which 
enable new procedures to be added to the 
basic DBQL code, either replacing exist- 
ing procedures or in addition to the original 
code. One useful addition is a menu driver 
program to enable the procedures to be 
called by a single key_press instead of an 
INPUT. Italso makes it possible to compile 
DBQL with QLiberator or Turbo, as com- 
piled versions of the procedures could not 
be called from the keyboard as at present. 
Special entry or display screens can be 
written as separate procedures and 
merged into DBQL when required. As an 
example of a multiple relational database 
application which can use these tech- 
niques, let's imagine you have been asked 
by the Secretary of your local camera club 
to show how he can use his QL computer 
to run the club membership and competi- 
tion records. 

By way of background information, a 
typical Camera Club, in addition tolectures, 
demonstrations etc., usually organises 
several competitions in which members 
enter their own photographs, either colour 
transparencies or colour or black and white 
prints. These are criticised by a visiting 
judge who awards points to each picture. 
Several print and slide competitions are 
held and at the end of the season, the 
members gaining the most points over the 
year in various categories are awarded 
trophies, to be kept for a year. 

In order to use a QL computer to keep 
records and work out scores two files 
would be required, as shown in listing 
one, one to hold information on members 
and the other on photographs. The 
members’ file (member dbf) might use 12 
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wrist 


fields as shown, the first nine of which are 
self explanatory. Each member has a 
membership number as a unique identifier 
and this is held in field 10. Fields 11 and 12 
hold cumulative totals of points awarded in 
club competitions for prints or colour slides 
respectively, 

The picture file (photos_dbf) is much 
shorter. Each picture is entered with a title 
as a unique identifier (field 1) and field 2 
specifies its type, print or colour slide. 
Field 3 holds the competition it was en- 
| tered in and field 4 the points awarded. 
| Field 5 is the membership number of the 

entrant. Thus we have two separate 

databases, related by the common field, 
membrnum. 

The two databases should be set up 
using CR. Member_dbf has one data field 
but no numeric fields, as the membership 
number might incorporate code letters and 
is best entered as a string. All the other 
fields are character fields. The longest 
field is likely to be the address but 25 
letters per field should be adequate. 
Photos_dbf uses character fields except 
for one numeric field, number 4. The files 
will eventually be used by loading 
member_dbf as alias 1 and photos_dbf as 
alias 2. Itis worthwhile creating the files at 
this stage and entering some records to 
test the following program. Once a few 
records have been entered they must be 
indexed on fields 10, 11 and 12 for 
member_dbf (membrnum, printpts and 
slidepts) and on field 4 for photos_dbf 
(points). 

The next step is to create a driver menu 
program (listing two). This will be merged 

| with DBQL and is going to take over the 
loading and operating of the databases; 
the standard DBQL menu will not be used. 

Note the empty lines 1000 and 1130 in 

listing two. These replace the original lines 

in DBQL so that START will no longer call 
the MENU. The driver first calls START to 
initalise DBQL and loads the databases in 
turn. After setting a narrow border to #1 to 
improve the display, the program enters 

the menu2 loop to display a new menu. A 

nested loop, check, awaits a keypress in 

240 and assigns the character to 

com(mand)$. Line 250 uses the INSTR 
function to check that the character is one 
of the list of acceptable numbers and if so 

EXITS check. If not, the loop returns to 240 
for another try, so that any keypress other 
than a permitted character is ignored. The 
program continues with a SELect struc- 
ture controlled by the number coerced 
from com in 270. 

Selecting 1 from the menu calls EN in 
alias 1 to enter data in member_dbf. This 
call will be diverted to a special input 
screen (see below}. Selecting 2 calls EN 
for photos_dbf and this will use the stand- 
ard EN procedure. Selections 3 to 5 call 
new procedures, specially written, which 
will have been merged along with the 
menu. Selection 6 sets the printer flag and 
7 EXITs menu2 and returns to DBQL com- 
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Listing 3. 


1250 
aactive 


=1:memberen a$,ann,afields,aresave,achars, aindices, andx$, 


8000 REMark ¥*#*#*#4%444*444%4%4% MEMBER _ENTRY 
8010 DEFine PROCedure memberen(x$,nn,fields,resave,chars, indices, 


ndx$, active) 

8020 BORDER 1,7:CLS:CLS#4:resave=1 
8030 PRINT#4," 
the end of each field"\" 

the Title field" 

8040 AT 1,34:PRINT’CAMERA CLUB" 


Type information field by field 


Key ENTER at 
To QUIT, Enter Shift/ESC in 


8050 AT 5,10:PRINT'Title":AT 5,30:PRINT "Forename":AT 5,50: PRINT 


“Surname” 


* 


8060 AT 9,5: PRINT “Address: ":AT 9,50:PRINT"Membership no.:":AT 
11,12:PRINT ":":AT 13,12: PRINT": ":AT 11,50: PRINT" Year joined: ":AT 
15,4:PRINT" Postcode: ":AT 17,3:PRINT"Phone no.:" 


8070 
8080 
8090 
8100 
6,50: PRINT blank$ 
8110 

8120 

PRINT 
8130 

8140 

8150 

8160 

8170 

8180 

8190 

8200 

8210 

8220 

8230 x${nn,9)=q$ 

8240 x$(nn,0)=" " 

8250 update_index 

8260 IF nn=DIMN(x$)THEN PRINT" Saving 
entryloop 

8270 END REPeat entryloop 

8280 PAPER 0 

8290 END DEFine memberen 


blank$=FILL$(" ",25)}:PAPER 2 
REPeat entryloop 
nn=nn+1 


x$(nn,1)=q$ 


9,14: INPUT x$(nn,4) 

11,14: INPUT x$(nn,5) 
13,14: INPUT x$(nn,6) 
15,14: INPUT x$(nn,7) 
17,14: INPUT x$(nn,8)} 
9,66: INPUT x$(nn,10) 


mand level after printing the DBQL menu. 
Line 360 prints a screen message and 
holds the screen display on PAUSE before 
reprinting the menu when another key is 
pressed. 

Acustomised screen for data entry makes 
the program more user-friendly and a 
procedure to do this is shown in listing 
three (MEMBEREN). It will replace the 
standard EN procedure when details of 
new members are to be entered. The 
general idea for the entry screen is to lay 
out prompts on a blank screen and then 
request an input at each prompt in turn. 
The first three lines of the procedure are as 
in ENTER but 8040 to 8060 print headings 
based on field names, using AT statements 
to position these at particular places (see 
the Sinclair QL User Guide, Keywords, 
page 3). The headings will remain on 
screen until the procedure is terminated. 

After setting up a string of spaces, blank$, 
and setting PAPER colour to red in 8070, 
the program goes into the entryloop and 
lines 8100 and 8120 print sections of blank$ 
under or next to the headings using red 
paper colour, so that these areas appear 
as lighter boxes on the screen, again using 
AT statements to locate the print position. 
Then lines 8130 to 8230 request an input 


6,31: INPUT x$(nn,2):AT 6,51: 


AT 6,10;PRINT blank$(1 TO 5):AT 6,30:PRINT blank$(1 TO 12);AT 


AT 9,13:PRINT blank$:AT 9,65:PRINT blank$(1 TO 6) 
AT 11,13:PRINT blank$:AT 11,62: 
blank$:AT 15,13:PRINT blank$:AT 17,13:PRINT blank$ 

AT 6,11: INPUT g$:IF q$=" THEN nn=nn-1:PAPER 0:EXIT entryloop 


PRINT blank$(1 TO 14):AT 13,13: 


INPUT x$(nn,3) 


11,62: q$=checkdate$:IF q$="" THEN q$="000000" 


to microdrive. Please wait.":EXIT 


for each field in turn, at the appropriate 
box, and the ‘title’ input gives the option of 
quitting the procedure by entering a copy- 
right sign (Shift/Esc). Note that 8220 calls 
the checkdate$ function to obtain the date 
and 8230 assigns it to field 9 of the record. 
No input is made to fields 11 and 12 at this 
stage and they do not appear on the screen. 
After the indexes have been updated, the 
program loops back to 8080 and clears the 
boxes but the prompts remain unchanged. 
The lines from 8240 onwards are the same 
as the standard EN except that 8280 resets 
PAPER colour to black. Note line 1250, 
which replaces the standard 1250 on 
MERGing and diverts the program to 
MEMBEREN when EN is called with alias 
setat1. . : 

After a competition has been held, the 
results need to be listed and the first of the 
new procedures, printout comp, (Listing 
four) is intended to display to screen or 
printer the title, points and author’s name 
for each picture entered in any specified 
competition, sorted in descending order of 
points scored, so that first, second and 
third come out in that order. To do this, 
information has to be taken from both 
databases and displayed on the screen, 
The name of the competition, such as 


‘prints 1' or ‘portraits’ ete is requested in 
8330 and a repeat loop, printout, is en- 
tered. Line 8360 prints a row of column 
headings and 8370 initialises a counter 
variable, count. 

Photos_dbfis held in b$ which has been 
indexed on field 4 (points) so that bndx$ 
holds the points scores, sorted in ascend- 
ing order, and the corresponding record 
number for each score. Although the en- 
tries in all of the competitions are mixed 
together, any one competition can be re- 
garded as a subset of the whole file and its 
entries will also be arranged in ascending 
score order. 

To find the entries in one competition, 
the program has to page through bndx$, 
starting at bnn, the highest score, and 
working back to 1. This is done by the 
FOR. . . NEXT LOOP starting at 8380. 
Line 8390 sets the current photos record, 
bc, equal to the record number stored in 
bndx$ and checks b$(3), the competition 
name of this record, against the specified 
name in competn§. If they do not match 
the program moves to 8470 and the next 
record but if a match is found then lines 
8410 to 8450 are executed. Line 8410 
sets s$ equal to the membership number 
of the entrant (field 5 of b$) and this is used 
in a binary search of the membrnum field 
of the member_dbf file, which is indexed 
in the first section of andx$, by calling the 
bin_s function in 8420. This returns the 
appropriate record number in a$ and the 
member_dbf record pointer, ac, is set 
equal to this. Then 8440 prints the counter, 
count; the title of the picture, b$ (bc,1); the 
points scored, b$ (bc,4); the author's initial, 
a$ (ac, 2,1) and the author's surname, a$ 
({ac,3). Output goes to screen or printer 
according to the value of chan, switched 
by 8480 as in the standard DISPLAY 
procedure. Finally, the counter is 
incremented in 8450 and the loop moves 
on to the next picture. 

After results of a new competition have 
been entered in photos_dbf, the cumula- 
tive points scores of the members will 
have to be updated and this is done by 
UPDATE_SCORE (listing five). First of 
all, the printpts and slidepts fields of all the 
members are set to zero by the loop in 
8620. The procedure will then take each 
picture in turn, find the record of its owner 
in a$ and add the picture's points score to 
the appropriate. . . pts field in the mem- 
ber’s record. The FOR. . . NEXT loop 
starting in 8630 takes each record in b$ in 
turn, sets s$ equal to the membership 
number of the entrant and calls bin_s to 
carry out a binary search in andx$(1), the 
membrnum index of a$. The member_dbf 
record pointer, ac, is set equal to the 
record number in 8660 and then lines 
8670 and 8680 add the picture’s points 
score, b$ (j,4), to printpts, a$ (ac,11), or 
slideptss, a$ (ac,12), according to whether 
the first letter of the picture type field, b$ 
(2), is p for print or s for slide. When all the 
pictures have been checked the proce- 
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Listing 4. 


8300 REMark *##*4#4444444442444444%% D[TSPLAY COMPETITION RESULTS 


8310 DEFine PROCedure printout_comp 
8320 CLS 


8330 INPUT\"Which competition? “;competn$ 


8940 CLS: PRINT 

8350 REPeat printout 

8360 PRINT#chan, " Title 
PRINT #chan 

8370 count=1 

8380 FOR j=bnn TO 1 STEP -1 

8390 be=bndx$(1,j,2) 

8400 IF b$(be,3)==competn$ THEN 
8410 s$=b$(bc,5):active=l:afld=10 
8420 z=bin_s(ann,s$,andx$} 
8430 ac=andx$(1,2,2) 


8440 PRINT#chan,count;". “;b$(bc,1);TO 30;b$(be,4) ,a$(ac,2,1)& 


". " kag$(ac,3) 
8450 count=count+1 
8460 END IF 
8470 END FOR j 


8480 IF lprint AND chan=1 THEN chan=3:NEXT printout 


8490 chan=1:EXIT printout 
8500 END REPeat printout 
8510 END DEFine printout_comp 


Listing 5. 


8600 REMark ***#44e¢¢04¢¢44e8¢¢9444e8%2 UPDATE SCORE 


8610 DEFine PROCedure update_ecore 

4620 FOR j=1 TO ann:a$(j,11)="0":a$(j,12)="0" 
8630 FOR j=1 TO bnn 

8640 s$=b$(j,5):active=1:sfld=10 

8650 s=bin_s (ann,s$,andx$} 

8660 ac=andx$(1,z,2) 


8670 IF b$(j,3,1)=="8" THEN a$(ac,12)=a${ac,12)+b$(j,4) 
8680 IF b$(j,3,1)=="p" THEN a$(ac,J1)=a$(ac,11)+b$(j,4) 


8690 END FOR j 

8700 use 1:wi 

8710 CLS:AT 10,29:PRINT “Scores now updated" 
8720 END DEFine update score 


Listing 6. 


8800 REMark **#*48444494%4444% LIST COMPETITION PLACINGS 


8810 DEFine PROCedure comp_place 


8820 CLS: PRINT#chan: PRINT#chan,TO 27;"COMPETITION PLACINGS" 
8830 PRINT#chan; PRINT#chan: PRINT#chan,TO 5;"Print competitions (pts)"; 
TO 45:PRINT#chan, "Slide competitiona {pta)":PRINT#chan 


8840 FOR j=ann TO ann-2 STEP ~1 

8850 ac=andx$(2,j,2) 

$860 PRINT#¥chan,\\ TO 5; ann-{j-1);"- 
andx$(2,j,1); 

$870 ac=andx$(3,j,2) 

8880 PRINT#chan, TO 45;ann-(j-1);". 
andx$(3,3,1} 

8890 END FOR j 


"sa$(ac,2,1);". “pa$(ac,3), 


"} a$(ac,2,1);". "jaS(ac,a), 


4900 TF lprint AND chan=1 THEN chan=3:comp_place 


8910 chan=1 
8920 END DEFine comp_place 


dure calls PAck with alias =1 to reindex 
the points fields and, incidentally, the 
membrnum field. It terminates with a 
screen message. 

The third new procedure, COMP_PLACE 
(Listing six), displays the first, second, 
and third prize winners, with cumulative 
points scores, for print and slide competi- 
tions. This has been written as a separate 
call from the menu but it could appropri- 
ately be called at the end of 
UPDATE_SCORE. Outputcan be directed 
to screen or printer as before. Lines 8820 
and 8830 print headings and aloop starting 
at 8840 is entered. This first of allexamines 
the last entry in the printpts index file to 
identify the member with the highest 
cumulative printpts score and prints out 
the initial, surname and score. It repeats 
this forthe slidepts index file. Itthen repeats 
the processes for the second and third 


highest scores in each category, paging 
downwards through the last three records 
of the index files. Simple print separators 
are used throughout as AT statements 
are not recognised by the printer, though 
PRINT TO. . . statements are. 

Listings two to six should be made up 
into a single program and saved to car- 
tridge or disc as; say, CAMCLUB_PRG. 
When DBQL has been loaded it should be 
started with the command MRUN 
mdv1i_CAMCLUB_PRG, which will 
MERGE the new program and RUN the 
combined program from the beginning. 

The above procedures illustrate princi- 
ples that are useful in other applications. 
The input screen is easily adapted for a 
name and address file or almost any other 
data entry. You might feel a driver menu 
would be a useful permanent feature in 
DBQL. The program in listing seven uses 
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the standard DBQL menu but the 
procedures are called by keying only the 
first letter of the name. Some procedures 
have been renamed to ensure that each 
starts with a different letter of the alphabet. 
DESelect has been changed to Reset, 
PAck has become Wipe and List has 
become View. Only the names have been 
changed and the code remains the same, 
but the names in the menu string in 1180 
should be changed to suit. The program 
should be MERGED with DBQL and, of 
course, can be used equally well with the 
flat_file version of DBQL. 

After initialisation by START, the screen 
is cleared and the main loop, menu2, begins 
by printing the MENU. The nested loop, 
check, waits for a keypress and checks 
com§$ against a string made up of the initial 
letters of all the procedures. When a valid 
character has been obtained a series of IF. 
.. THEN statements calls the appropriate 
procedure. A SELect structure cannot be 
used as Superbasic does not SELect on 
strings. Note that G and U (se) expect a 
number to be passed and this is requested 
in 240 and 330 respectively. The advan- 
tage of this type of inputis thatnon-character 
keys can be brought into use, for example, 
the up and down arrow keys can be used 
instead of N or B to move between records 
and the Function keys could be used to call 


Listing 7. 


100 start 

110 CLS: CLS#0 

120 REPeat menu2 

130 menu 

140 REPeat check 

150 com$=1NKEY${-1) 


160 IF com$INSTRabcdefgilmnopqrsuvw" THEN EXIT check 


170 END REPeat check 

180 com$=="a" THEN am 
190 com$=="b" THEN b 
200 com$=="c" THEN cr 
210 com$=="d" THEN del 
220 com$=="e" THEN en 
230 ‘ com$=="f" THEN fi 


240 com$=="g" THEN JNPUT\" Number? "jx: x 


250 ’ com$=="i" THEN in 

260 com$=="1" THEN lo 

270 ? com$=="m" THEN mo 

240 com$=="n" THEN n 

230 * com$=="0" THEN op 

300 com$=="p" THEN pr 

310 ? com$=="q" THEN quit: EXIT men2 
320 ' com$=="r" THEN des 

330 ' com$=="s" THEN se 


340 com$=="u" THEN INPUT” Number? ";x:use x 


350 com$=="v" THEN 1i 
360 ? com$="w" THEN pa 
370 END REPeat menu2 

380 STOP 

1000 : 

1130 : 


some procedures. All these keys return a_ the check string &CHR&§(y). .. They can be 
character string (see Sinclair QL User executed by a statement such as IF com$- 
Guide, Concepts pp 5-9) which can be CHR$ (208) THEN... foran up arrow. The 
tested for in 160 by adding the following to only disadvantage is that access is lost to 


useful Superbasic commands such as DIR 
or COPY but special procedures can be 
written to use such commands in response 
to, say, one of the Function keys. 
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n the first article in this series, we intro- 
duced a set of small code chunks, de- 
signed to perform simple, obvious 
functions. The idea is that it should be 
clear what they do, how they do it, and 
more important, how they might need to be 
modified when joined together to make 
programs. To this end, each chunk is 
comprehensively annotated. 

In this article we shall put together a 
simple, though useful, multitasking pro- 
gram, using the chunks of code produced 
last time. 

This program will transfer bytes from one 
channel to another. The input channel 
would normally be a file on disk or 
microdrive, and the output channel could 
be a screen window, or a printer, or an- 
other disk or microdrive file. In other words, 
the program will copy a file to another file, 
or to the screen so we can view it, orto a 
printer to get a hard copy. And this can 
happen while your QL is being used for 
something else! The best use is in 
outputting to a printer, which is always a 
long job because printers are far slower 
than computers, and while the printer is 
working, the computer has lots of time to 
get on with other things. 

First of all, we need to draft out the steps 
the program needs to go through to ac- 
complish its task. (Professionals would 
probably do this as a flow chart, but | shall 
simply write a list of statements). 

1. We need the standard way of starting 
a multitasking job. We start with 
JOBSTART. 

2. We need to set the priority of the job, 
so next use PRIORITY. 

3. We need to open a console window to 
input the channel names, so we use CON- 
SOLE. 

4. We need to print a prompt to the 
screen to ask for an input channel name, 
so we use MESSAGE. 

5. The channel name will come as a 
string from the keyboard, so we store it in 
a buffer using INSTRING. 

6. Having collected the channel name, 
we need to open a channel using OPEN. 

7. We will now need to repeat steps 4, 5 
and 6 to get an output channel, so we use 
MESSAGE, INSTRING, and OPEN again. 


Machine 


rogramm 


Part 2 of our new 
series by Alan 
Bridewell 


8. We are going to use some spare ram 
in the common heap as a buffer for the 
bytes in order to reduce to a minimum the 
number of times we access microdrives 
(or disks), so we use GETHEAP. 

9. Now we can do the actual file transfer 
using STRINGTR. 

10. Having completed the transfer, we 


Listing t 


OPEN THE CONSOLE CHANNEL 


Se 


stemati 


Code 


need to tidy up by closing the two channels 
and the console window using CLOSE 
three times. 
11. Finally, we kill the job using ENDJOB. 
Putting all that together, what we have to 
do is merge the routines in this order: 


JOBSTART, PRIORITY, CONSOLE, 
MESSAGE, INSTRING, OPEN, MES- 
SAGE, INSTRING, OPEN, GETHEAP, 
STRINGTR, CLOSE, CLOSE, CLOSE, 
ENDJOB. 

This then leaves us with the job of mak- 
ing all the little changes needed to join the 


3 ME EEE FE FE HE SE AE A He th A A EE A EH a a a a a A Ha a a 


3 ‘ JOBSTART * 

‘ BRA.S START 3 BRANCH TO START OF CODE 
DC.L ° } (THIS IS STANDARD FORMAT FOR 
DC. Ww. $40FB 3 START OF A JOB) 

:  ---~ ALTER CHARACTER COUNT AND JOB NAME ~~-— 
DC.W 8 } CHARACTER COUNT OF JOB NAME 
DC.B ‘TRANSFER’ ; NAME OF JOB 


9 TOE He He TR Ti ab eA ATE ab 9 JE a 9 EE 4 9 a a a 0 nn 0 a 0 a 


5 

H 

3 ‘PRIORITY ‘ 

5 

} ---~ ALTER LABEL TO ,8TART ---- i 

«START MOVEQ ##8 ,DO 1 MT_PRIOR IN DO 
MOVEO #-1,Di } OF THIS JOB 
MOVEQ #1,D2 3 TO1 
TRAP wt 


96-98-96 AR 4 EE EI i a EE a 
“CONSOLE” 


LEA.L PBLOCK,Ai 1 PBLOCK ADDRESS IN Ai 
MOVEA.W $C6,A2 3 UT_CON VECTOR IN AZ 
JSR (AZ? 


} SAVE THE CHANNEL ID WHICH UT_CON ROUTINE LEAVES IN AO. 


MOVE.L A, - (7) } SAVE CONSOLE ID ON STACK 

j 

; CLEAR THE WINDOW 

5 
MOVE. W @sFFFF,D3 } INFINITE TIMEOUT 
MOVEG ##20,D0 } #SD_CLEAR IN DO 
TRAP #3 

} ---- ALTER BRANCH ADDRESS TO MESS1 ---- 
BRA.S MEBBL ) SKIP BLOCK 

5 

; DEFINITION BLOCK. 

5 

} ---- ALTER BLOCK TO GIVE REQUIRED WINDOW —~—~ 

~ PBLOCK pc.B 2 | RED BORDER 
DC.B 2 } 2 PEXELS WIDE 
DC.B 0 } BLACK PAPER/STRIP 
DC.B 4 } GREEN INK 
DC.wW 400 } WIDTH 
DC. W 24 } HEIGHT 
pC.W So + X POSITION 
DC. W 6 3 Y POSITION 
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chunks together into a coherent (and, we 
hope, working) program. Basically, this 
involves doing the following: 

1. Move buffers, etc. to the end of the 
program, and delete any which have been 
unnecessarily duplicated. 

2. Where chunks are repeated, we must 
alter some labels to ensure they are unique. 

3. Adjust the window data block to give 
us the window we want. 

4. Adjust the two message strings to give 
the prompts we want. 

5. Each time we access data from the 
stack, check carefully the stack pointer to 


ALTER LABEL TO .MESS1 ---—— 


a ee 


MESS1 LEA.L 
MOVE. W $DO0,AZ 
JBR (A2) 


BRA.S 
ALTER LABEL TO .MESSAGE1 ——— 


» MESSAGE 1 DC. 12 


DC.B 


$ 
T Tih dis tiathothathothathe Rahat ehaliahatahhadaiahahahsRehshadateRehetaiedaRehaatatstetaiehehitetaiaieRehehataheRiedaiiieheaiaiadehshaiehshaieheiehel 


1 ‘ “INSTRING ‘ 

’ 

} -——- ALTER LABEL TO .STRING1 ---~ 

« STRINGL MOVE.L (a7) ,AO } CONSOLE CHANNEL ID IN AO 
MOVE #BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 
MOVE. @SFFFF,DS  » INFINITE TIMEOUT 
LEA.L BUFFER,A1 | BASE ADDRESS OF BUFFER IN A1 
MOVEQ ##2,D0 | 5 @I0_FLINE IN DO 
TRAP as 
LEA.L BUF_POS,AO 4 BUF_POS IN AO 


SUBQ.L = #1, D1 


MOVE .W D1, (AO) 


ee 


‘OPEN’ 
LEA.L BUF_POS,AQ 4 BUF_PODS IN AO 
MOVES #1,D3 } OPEN OLD SHARED FILE 
MOVEQ #-1,D1 } JOB 1D FOR THIS JOB 
MOVEO ##1,D0 } #I0_GPEN IN DO 
TRAP #2 
TST.L DO 1 ERROR? 
} ~~-- ALTER BRANCH ADDRESS TO GOTFILE1 ---- 
BEQ.S GUTFILE1 } IF NOT, THEN CONTINUE. ELSE1— 
; 
i PRINT ERROR MESSAGE 
i 
MOVE.L (A7),80 4 CONSOLE CHANNEL ID IN AO 
MOVE.W CC, AZ } UT_ERR IN A2 
JSR (a2) } PRINT ERROR MESSAGE 


| 
GO BACK TO SCREEN PROMPT FOR INPUT 
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ALTER LOAD ADDRESS TO MESSAGE ---—— 
MESSAGE1,Al 7 BABE ADDRESS IN Al 


ALTER BRANCH ADDRESS TO STRINGI —--—— 
STRING1 


ALTER CHARACTER COUNT AND MESSAGE ---~ 
“PRINT FILEs ‘ 


---- BUFFER, ETC MOVED TO BOTTOM OF CODE ---- 
(A A a A I A a a ab a a EE i a a a Hb a a a 


see if we need (A7) ,A0 or 4{A7) ,AO ...etc. 
and alter the code accordingly. (This is 
probably the part where mistakes are most 
likely to occur, and needs to be done very 
carefully.) 

6. Remove all unwanted comments and 
annotation, and put in ones we actually 
want for this program. 

One way of doing this (assuming you 
have aprinter) is by having a printout of the 
merged chunks of code, and then making 
alterations to this by hand, before altering 
the actual program. Alternatively, you can 
alter each chunk as it is merged into your 
listing file. Listing one shows the results 
of this work, but with two differences. In 
order to show how the final listing relates 
to the merged chunks of code, it contains 
the following: 

1. Rows of asterisks left between each 
chunk. 

2. Additional comments added to show 
where the code needs to be changed. 
These comments start and end with “—— 

Both of these can be left out of your own 
final listing. If you make mistakes or omis- 
sions in these alterations, most of them will 
be picked up by the assembler and re- 
jected. The error message will then tell you 
what to put right. The biggest problem is in 
moving the channel ID from the stack into 


} UT_MTEXT VECTOR IN AZ 


5 BKIP MESSAGE 


5 LENGTH OF MESSAGE 


3} SUBTRACT 1 FROM THE Di REMOVES 
1 THE LF FROM THE STRING COUNT. 
3} PUT NEW STRING LENGTH IN BUF _POS 


MACHINE CODE 


AO. If you make a mistake here, the as- 
sembler will not spot it, and the program 
will run using the wrong channel |D. This 
will probably result in it doing nothing — not 
very informative. Watch out for this one. 

Although it may be fairly self-evident 
from listing one, we will go through the 
steps needed to be carried out if we were 
going to merge the chunks and alter them 
as we merge them. We can leave out any 
instructions regarding the deletion of un- 
wanted remarks. That is basically a “tidy 
up the listing” job, and does not affect the 
code. 

1. Merge ‘Jobstart’ into the file. Alter 
character count and job name. (This is 
methodical, but not essential. We can call 
the job anything we like.) 

2. Merge ‘Priority’ into the file. Alter the 
label to ‘.START’, because it's the start of 
the code proper. 

3. Merge ‘Console’ into the file. Alter the 
window definition block to the required 
size. The parameters | have put in listing 
one give two rows of the width of the 
screen, with a red border, and green text 
on a black background. Change them if 
you prefer something different. Also, when 
we skip over the definition block, we go to 
‘Message’, which occurs twice in the pro- 
gram, they need unique labels, so alter the 
branch address to ‘MESS1’. 

4. Merge ‘Message into the file. Alter the 
label to “.MESS1’, the load address to 
‘MESSAGE1’, and the label of the mes- 
sage itself to ‘ MESSAGE1’. The actual 
character count and message need altering 
to something appropriate. I've called it 
‘PRINT FILE:', but you can call it what you 
like. We need to skip over the message, 
and the next bitis ‘Instring', but as itoccurs 
twice, we can alter the branch address to 
‘STRING1’. 

5. Merge ‘Instring’ into the file. Alter the 
labelto’. STRING1’. The buffer block needs 
to be at the end of the code, so position the 
cursor so that subsequent chunks merge 
above the buffer block. 

6. Merge ‘Open’ into the file. As this will 
occur twice, we need unique labels. So 
alter the first branch address to‘'GOTFILE1’ 
and the corresponding label to 
‘“.GOTFILE1’. Also, in the case of error, we 
want to go back to the first prompt, so alter 
that branch address to 'MESS1’. 

At this point, we start to repeat ourselves 
as we try to open an output channel. 

7. Merge ‘Message into the file. Alter the 
label to “.MESS2’, the load address to 
‘MESSAGE2’, the actual message label to 
‘MESSAGE2’, and the branch address to 
skip over the message to ‘STRING2’. The 
message itself needs to be changed to 
something appropriate. I’ve called it 
‘PRINTER DEVICE: ‘. Here we come to 
the first stack problem. As we have opened 
a second channel, the console ID is no 
longer on the top of the stack, but four 
bytes away. So the MOVE.L command 
must be altered to 4(A7) ,AO. 

8. Merge ‘Instring’ into the file. Alter its 
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label to". STRING2" and because the con- 
sole channel ID is four bytes away from 
the top of the stack, we need to alter the 
MOVE.L command to 4(A7) ,AO. The 
buffer, etc. was already included the first 
time we used ‘Instring’, so this time it can 
be deleted. 

9. Merge ‘Open’ into the file. To distin- 
guish this from the first time we used 
‘Open’, alter the first branch address to 
‘GOTFILE2’ and the corresponding label 
to “.GOTFILE2’. In the case of error, we 
want to go back to the second prompt, so 
alter that branch address to ‘MESS2’. The 
other difference from the first ‘Open’ is the 
type of file. Whether we output to a printer, 
screen, or magnetic medium, we will be 
using a new file, and it must be for the 
exclusive use of this program (at least 
while it is running). So the first MOVEQ 
command must be altered to #2,D3. 

10. Merge ‘Getheap’ into the file. Alter 
the branch address for skipping over the 
heap allocation block to ‘FILE_P’. | have 
the program allocating (or trying to allo- 
cate) 4096 bytes of heap space. You can 
increase or decrease this, depending on 
your available ram, how many jobs you 
think will multitask together, andthe length 
of file you might wish to copy. 

11. Merge ‘Stringtr’ into the file. As the 
last channel opened was to the outputfile, 
the input channel ID is four bytes from the 
top of the stack. So alter the first MOVE.L 
command to 4(A7) ,AO. The next few lines 
need to be changed to the alternatives in 
the comment field, because we are using 
common heap space as a buffer, rather 
than the buffer at the end of the code. So, 
delete the two lines 


MOVEQ #BUF_LEN,D2 
LEA.L BUFFER,A1 


and replace them with the lines 


LEA.L HEAP_LENGTH,A1 
MOVE.L —_(A1) ,D2 
LEA.L HEAP_ADDR,A1 
MOVE.L —_(A1) At 


We need a similar change to deal with 
the output file. So delete the line 


LEA.L BUFFER,A1 
and replace with the lines 


LEA.L HEAP_ADDR 
MOVE.L (At) At 


12. Merge three copies of ‘Close’ into the 
file. This is to close the output and input 
channels, and the console window. Alter 
the labels onthe three copies to’.CLOSE1’, 
‘CLOSE2' and '.CLOSE3’. On the first 
two copies, delete the BRA.S END_JOB 
line. 

13. Merge ‘Endjob’ into the file. 

14, Make sure the buffer block is at the 
end of the code. 
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3 
} ---- ALTER BRANCH ADDRESS TO MESS1 --~~- 
BRA.8 MEBSS1 } LOOP BACK TO MESS! 


5 
3; IF NO ERROR, THEN THIS CODE 18 UBED 


3 
3 —---~ ALTER LABEL TO .GOTFILEi -—--- 


-GOTFILE1 MOVE.L A0,-(A7) 4 SAVE CHANNEL ID ON STACK 


; FE ERE IE AE FE ae A 0 EE Ee BS EAE EAE 

3 "MESSAGE * 

3 

j ---- ALTER LABEL TO .MESB2 ---~ 

} -~-- ALTER MOVE.L COMMAND TO 4{A7),AO —-— 

«MESS2 MOVE.L”  4(47),A0 4 CHANNEL ID IN AO 

j ---- ALTER LOAD ADDRESS TO MESSAGE2 —-— 
LEA.L MESSAGE2,A1 ; BASE ADDRESS IN Al 
MOVE.W $DO0,A2 3 UT_MTEXT VECTOR IN AZ 
JBR (A2) 

} ---- ALTER BRANCH ADDRESS TO STRING2 ---~ 
BRA.B STRING2 } SKIP MESSAGE 


5 
} ---- ALTER LABEL TO .MESBABEZ ---- 


} ---- ALTER CHARACTER COUNT AND MESSAGE ——-—~ 
DC.W 16 3 LENGTH OF MESSAGE 
DcC.B ‘PRINTER DEVICE: ‘ 


(FA a A TE SE AE EE AE TEE REE IE AE A EE TE FE EEE aE EEE EEE JE FTE FE TET EEC TEE I EE EE aE a 
"INSTRING* 


---- ALTER LABEL TO .STRING2Z —-—— 

---- ALTER MOVE.L COMMAND TO 4(A7),AQ ---~ 

STRINGZ MOVE .L 41(A7),A0 3 CONSOLE CHANNEL ID IN AO 
MDVEQ #BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 
MOVE. W #$FFFF,D3 3 INFINITE TIMEOUT 
LEA.L BASE ADDRESS OF BUFFER IN Al 
MOVED #10 _FLINE IN DO 
TRAP 
LEA.L ai 3 BUF_POB IN AD 
SUB. L SUBTRACT 1 FROM THE Di REMOVES 

3 THE LF FROM THE STRING COUNT. 

MOVE. W PUT NEW STRING LENGTH IN BUF _POS 


---- BUFFER, ETC DELETED BECAUSE THEY ARE DUPLICATED ---- 
“TREE RRR AR FE AREER EH IEEE TE EE ab aR EEE IEE EEE TE IE A IEE EI IE EE EE 
"OPEN ' 


LEA.L BUF_PO0S,AO ; BUF_POS IN AO 
—--— ALTER TO MOVEG #2,D3 FOR NEW EXCLUSIVE FILE —--- 
MOVEG #2,D3 3 #2 = NEW EXCLUSIVE FILE 
MOVEG #-1,D1 3 JOB ED FOR THIS JOB 
MOVED ##1,DO > #10_OPEN IN DO 
TRAP #2 
TST.L Do 3 ERROR? 
---- ALTER BRANCH ADDRESS TO GOTFILE2 —~—- 
BEQ.S BOTFILE2 3; IF NOT, THEN CONTINUE. ELSE?- 


PRINT ERROR MESSAGE 
MOVE. L. (A7) ,A0 


MOVE. Ww $CC,A2 
dsr (A2) 


3 CONSOLE CHANNEL ID IN AO 
3 UT_ERR IN AZ 
} PRINT ERROR MESSAGE 


GO BACK TO SCREEN PROMPT FOR INPUT 


---- ALTER BRANCH ADDRESS TO MESS2 -—--— 
BRA.S MESS2 3 LOOP BACK TO MESS2 


IF NO ERROR, THEN THIS CODE 1S USED 


—+-- ALTER LABEL TO GOTFILE2 --~~ 
- GOTFILE2 MOVE.L A0,—{A7) 4 SAVE CHANNEL ID ON STACK 
5 
i EEE ETE AE A IEE HE AE 9R AR AE SE TFET EE EEE SEE EE EAE EE ETE IEE EEE ITE IEE ETE TEE ETE TEI EI E 
3 “GETHEAP * 
3 
MOVE.L #HEAP_ROOM,Di 4 BYTES REQUIRED IN D1 
. BET_ROOM MOVER #-1,D2 3 ID FOR THIS JOB IN D2 
MOVER © ##16,D0 @MT_ALCHP IN ‘DO 


TRAP #1 TRY TO GET RAM 
TST.L BO ERROR 


DIVIDE BYTES REQUIRED BY 2 
IF Di<=1 STOP WITH ERROR 
ELSE LOOP AND TRY AGAIN 


LSR.L #1,Di 
CMPI.L #1,D1 


3 
; 
3 
BEG.S GOT_AREA 5 YES, THEN CONTINUE. ELSE:— 
J 
3 
; 


BGET.S BET_ROOM 
BRA. 3 JOB_END 


HAVING GOT SPACE ALLOCATED, WE MUST SAVE ADDRESS AND NUMBER OF BYTES 
ALLOCATED. 


GOT_AREA LEA.L HEAP _LENGTH,Ai 
MOVE.L Di,{Al) 4 SAVE NUMBER OF BYTES 
LEA.L HEAP_ADDR,A1 
MOVE.L AO, (Al) =; SAVE AREA ADDRESS 
3 ---- ALTER BRANCH ADDRESS TO FILE_P —--- 
BRA.S FILE_P } SKIP HEAP ALLOCATION BLOCK 
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If you complete that successfully, you [? 


should have a listing which will assemble 
into a multitasking program. You could, of 
course, simply copy listing one. But that 
would completely defeat the point of the 
article. The program itself is nothing spe- 
cial. It's one of many short routines which 
perform more or less the same job. Many 
professional packages have something 
similar built into them. | would not even 
claim this as my own. As | said in the first 
part of this series, | taught myself originally 
by reading Adam Denning's Advanced QL 
Machine Code, and much of what | have 
learned was by taking his programs apart 
and using the bits. Here we have almost 
put one of his routines together again. 

There are two points to this. One is that it 
well illustrates the process, where pre- 
pared chunks of code can be turned into a 
program. The other is that this program 
contains elements that nearly all programs 
will need to have to get started; how we 
start a job, open console channels, input 
and output strings, open and close files, 
transfer data, and finally kill jobs. This 
means that in the rest of this series, what- 
ever the particular point we are trying to 
illustrate, we can write it into a program that 
will work. 

As | pointed out in the first article, this 
series is not intended as a beginner's tu- 
torial in assembler language programming. 
Ifyou don't already know alittle of it (enough 
tobe able to READ alisting and understand 
the individual program lines, even if you 
cannot WRITE a program), then clearly 
you will need a suitable guide before this 
series of articles makes much sense to 
you. 

Copying listings, or even following alist of 
instructions, successfully does not mean 
that you understand what you are doing. 
But if you put these instructions into prac- 
tice, by now you should begin to under- 
stand what is going on. A good way to test 
this, and to practice using this machine 
code toolkit (as | like to think of it) is to try 
rewriting the program to do something 
slightly different. Here are some sugges- 
tions. 

1. To start with, simply change the pa- 
rameters of the console window. 

2. Open another console window so that 
the input file is automatically copied to the 
screen as well as the selected output de- 
vice. 

3. Write a program so that when its cursor 
is flashing, all keyboard input automati- 
cally dumps to the output channel you 
choose (printer, mdv, flp, etc.), as well as to 
the screen. 

If you have understood these first two 
articles, these should not be too difficult. 

In the next article, we are going to deal 
with the whole matter of screen output 
control, clearing, scrolling, panning, csize, 
cursor position and so on. This will enable 
us to turn the visual impact of our programs 
into whatever our imaginations will allow. 
Happy coding! 
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MACHINE CODE 


HEAP ALLOCATION BLOCK 


HEAP _ROOM Eau 4096 3 HEAP ROOM REQUESTED 
.» HEAP_ADDR DC.L oO 3 SPACE FOR HEAP ADDRESS 
» HEAP_LENGTH DC.L ° 3} SPACE FOR LENGTH OF HEAP SPACE 


RIERA IE SE EAE AE SEE IE ETEE FE EAE JESEEE E-TE HE EJ EE DE EIR  EE EE a E E  E  e 
“BTRINGTR* 


FIRST WE FETCH THE STRING FROM THE INFILE 
---- ALTER MOVE.L COMMAND TO 4(A7) ,AO —--- 
-FILE_P MOVE.L 4(A7),A0 3 ENFILE_ID IN AQ 
} ---— ALTER NEXT FEW LINES TO HEAP_LENGTH AND HEAP_ADDR —--- 
3 ---- RATHER THAN BUF_LEN AND BUFFER —--~ 
LEA.L HEAP_LENGTH,AL 
MOVE. (A1),D2 3 LENGTH OF BUFFER IN D2 
LEA.L HEAP_ADDR,AL 
MOVE. L (A1),Al 3 BUFFER ADDRESS IN Ai 
MOVE. W #SFFFF,D3 3; INFINITE TIMEOUT 
MOVEO #3 ,DO ; #I0_FSTRG IN DO 
TRAP #3 3; FETCH STRING 
MOVE.L DO,-(A7) 3 SAVE ERROR RETURN ON STACK 


NEXT WE SEND STRING TO OUTFILE 


MOVE.L  4(A7),A0 5 OUTFILE_ID IN AO 
---- ALTER TO USE HEAP_ADDR RATHER THAN BUFFER -~—-— 

LEA.L HEAP_ADDR,A1 

MOVE.L (Al), AL 3 BUFFER ADDRESS IN Al 

MOVE.L Bi,D2 3 ID_FSTRG LEAVES THE NUMBER OF 
5 BYTES ACTUALLY FETCHED IN Di 
3 SO WE PUT THIS IN D2 

MOVEQ #67 ,DO 3 

TRAP #3 3 


#I0_SSTRG IN DO 
SEND STRING 


AT THIS POINT WE NEED TO KNOW IF WE HAVE REACHED FHE END OF THE FILE. 
80 WE EXAMINE THE ERROR RETURN SAVED ON THE STACK. 


MOVE. (A7>+,DO 5 PUT ERROR RETURN BACK IN DO 
TST.L De 3 ERROR? 
BEQ.S FILE_P 3 NO, THEN LOOP FOR NEXT STRING 


FEE AE EE SEAR AE AE TE a TE EEE HE TEAR ETE EE JETT SEE TEE YE FETE TIE FE AE EEE JER ALTE AE EEE JE TEE TE AE FEIT EEA TET IE TE IEE IEE 
“CLOSE ’ 


--~-- ALTER LABEL TO .CLOSE1 -~--- 

CLOSE1 MOVE.L (A7)+,AO 3 CHANNEL ID IN AO 
MOVE #$2,D0 3 IO_CLOBE IN DO 
TRAP #2 


~-~- DELETE BRA.S END_JOB ---—~ 
ERE IIIS ETHIE IEEE IEE IEEE III IIIT IEEE TEI ITER IE HE IE 


“CLOSE ’ 


ALTER LABEL TO .CLOSE2 ———— 
MOVE. |. (A7)+,A0 3 CHANNEL ID IN AG 
MOVE #%2,D0 3 IO_CLOSE IN bo 
TRAP #2 


---- DELETE BRA.S END _JOB --~—— 
(9 AE AE FEE A 9 0 aE Ea a8 9 a a a EF EE IE AE A nb REE SE EI EE aE EE TE TE TEAR EE JET TE Tr aE 


“CLOSE * 


---~ ALTER LABEL TO .CLOSE3 --—- 

CLOSES MOVE.L.  {A7)+,AO 3 CHANNEL ID IN AO 
maveg #$2,D0 3: ID_CLOSE IN DO 
TRAP #2 

: BRA.S END_JOB 

; 9M He He eH A A HH HE A A EE RE TE AEE EEE ESE EAE EEE AE TEESE IEE EEE EEE EE HE EE 

, “ENDJOB° 

i 


JOB_END MOVE.W #5CA,A2 3 UT_ERRO IN A2 
JSR (A2} 


: THE NEXT PART IS THE NORMAL ENDING OF A JOB BY KILLING If. 


5 
.END_JOB MOVEQ #45 ,,D0 3 MT_FRJGB IN DO 
MOVE@ #-1,Di 3 ID OF THIS JOB IN Dt 


TRAP @1 


HE EEE EEE EE J FE JE JE SEE AE JE HE SEE SEE a Te gE EH a EE a a A a a a a HE eH ae 


---- THIS PART WAS MOVED TO THE END FROM INSTRING --~~— 
WE NEED ‘BUFFER’ FOR THE STRING AND ‘BUF_POS' FOR THE STRING COUNT 


- BUF _LEN 3 LENGTH OF INPUT BUFFER 


H 
. BUF_POS 


5 
- BUFFER 


3 
3 #248 NOTE ##*% BUFFER SHOULD COME LAST OF ALL. 


3 
3 EE EEE IEE EERIE REFEREE TEE TE ETE TE ESE SE AE TE AE JETER TE ETE AE EAE TE EEE ESE ETE TET TE TEE EE 


——| 
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fehen)Merz Softw 


| sburg 11 - Germany 


Jochen Merz Software is the largest supplier of high quality software that runs under QJUMPS’s Pointer Environment (PE). This 


hardware — independent environment is the very advanced and easy to use windowin 
te future for QL users. We support the PE by puppiying software development tools, 
e QL. It combines the power of ATARI’s ST computers (which are very good 


The QL-Emulator is an advanced replacement for 


value) with the extraordinary performance of the QL’s operating system and the PE. More than 5 


150 are used professionally. 


system for QDOS, that is the path to 
locumentation and the QL-Emulator. 


Emulators have been sold. 


For more details on our complete range of products write or send a fax! 


QD Ill - The first (and only} Editom using the PE. Dynamic memory 
allocation, no limit on nrs of fines, comfortable block-handling and many, 
many features. £38 


QMenu - the Menu Extension QMenu is a very easy to use interface with 

re-defined menus {e.g. file-select, simple-choice boxes, select from lists). 
Thea menus may be used from SuperBASIC, machine code and other 
languages. £11 


QSUP - System Utility Ronicge Different sorts of programs and extensions 
which help you setting up and usiing your machine (e.g. Translation-Table 
Editor, Notepad), £26 


Thing & EPROM Manager Do you want to put your Extensions, Things, Jobs 
etc. into EPROM? The EPROM Manager helps you by creating files which 
are ready-to-burn. It contains also the very pine + Thing Extension II, which 
gives you full control over Things from SuperBASIC. £18.50 


Fifi - the FileFinder Running under the PE, Fifi is easy to use and extremely 
useful, FiFi scans devices or directory trees and searches files or filenames 
for strings. Combinations are possible, e.g. String 1 AND String 2 BUT 
NOT String 3 etc. £16 


DISA - Intelligent Disassembler which allows you to disassemble interac- 
tively any kind of machine-code. Completely pointer-controlled = very eas 

to use. Generates ASCll-output aiien may ie assembled using the Gt 
(Macro) Assembler. DISA also tries to insert label names (used in the 
Techinal Guide and the Reference Manual), and also knows QDOS 
standards (e.g. Proc/Fn tables, ROM-headers, CONHG-format etc.) £29 


QDOS Reference Manual - This book is a must for all m-code programmers. 
It explains how to use QDOS, all traps and vectors, the Thing System, the 
HOTKEY System Il and much more. It points out which features work on a 
QL, an Emulator and how to write compatible for the future operating 
systems. DIN A5, 170 pages. £30 


QPTR - The Pointer Environment Toolkit Revised manual which describes 
how touse the Pointer Interface and the Window Manager from SuperBASIC 
and machine-code, QPTR comes with examples on disc, keys, macros an 
extensions for SuperBASIC, £30 


FLP/RAM Level 2 - Replacement EPROM for SuperQBoards (V1.17 
onwards, with & without mouse} and all TrumpCards. New Manual! Real 
sub-directories! QL-Emulator compatible! Abouttwice as fast, with improved 
slave-block-handling! £15 


EASYPTR Il - Create your own PE menus & sprites, use them in your own 
SuperBASIC or machine-code programs. Creating Menus was not easy, 
until now! Put all the items you aad on screen, thats it! Supports all the PE 
facilities, even split sub-windows and uses the Menu Extension! Now even 
complete application-sub-windows may be created! Many examples and 
better manual! NOW AVAILABLE! £4! 


QDesign Graphic and Design-program, also running completely under 
the PE! Supports the Extended Mode4. Do you think anything else Is to sa 
about a very good graphics program?! For?, 18 and 24 pin printers £38 
or for Deskjet and Laserjet £45 


Font-Vector-Editor for QDesign £19 


DataDesign - Database program Access via menu or from SuperBASIC/ 
machine code. Many features, ome field sizes ae lines in a field), 
Very fast sort. Archive export files may be imported! 


| QPrommer Eprom-Programmer software for the ATARI ST together with the 
Junior-Prommer. This software allows you to burn EPROMs from2716 up 
to 27512, 27513 and 27011. With a special adaptor, even EPROMs up 
to 27080, It burns while the machine continues to work and offers many 
features. £19 


QIMIs (Mouse Interface for QL} 

— with real-time-clock-battery-backup £41 
- without RTC (for GoldCard etc.) £37.50 
Mouse for QIMI & ATARI ST £24 


Mousepad, black, with QL’s character set table £3.50 


QL-Emulator for ATARI ST 
(260, 520, 1040 and all Mega’s, but no STE’s). This hardware, together with 
software turns any ATARI into a QL. The emulator supports the standard MODE 
4.as well as a MODE 4 in much higher resolution (768x280), 
The QL emulator does not interfere with AT-emulators, it also runs even faster 
if accelarator cards (HyperCache, AdSpeed) are built into the machine, Of 
course, it supports ae subdirectories (complete Level 2 device drivers} on 
floppy, hard-disk and RAM-disc. 
The complete QL emulator package includes a lot of utility sofware and 
extensions, 
Ifyou are interested in an emulator, you should write for more information £166 


EPROM Cartridge for the QL-Emulator, switchable 

— Containing the standard drivers £33 

- containing the extended drivers £33 

Floppy adaptor to connect QL discdrives to the ST £9 
Monitor-cable ATARI to Scart £9 

Centronics-cable 2m £6.50 

Centronics-cable 5m £10.50 


Diamonds £11 
BrainSmasher £12 
Arcanoid £10 
Firebirds £10 
SuperGamesPack £25 
QShang £14 


Updates 
Our update policy is very generous: updates on most products are free! 
Upgrades (i.e. major improvements on the products) are available at small 
charges. In general you only have to pay if new manuals are required. For 
updates and upgrades, just return the original disc and enough return postage 
(none, if updates come with an order, £2 for up to 5 discs or £4 for more. 
Upgrades to QD Ill from previous versions £10 
Upgrade to QSUP from QSYS I to Il £19 
Upgrade to QPTR (with new manual) £14 
Upgrade to EasyPTR Il from V1 £13 
Upgrade to QDesignLaser from normal £7 
New Emulator manual £6 


Special offers 
Pack of 10 3.5" discs MF2DD £3.10 
Pack of 10 3.5" discs MF2HD £6.30 


Please add £4.00 for postage and package (Europe) or £4 for one item and 
£2.50 for every further item (Overseas). 
All prices excl. V.A.T. E&OE. 


6 nose ,Cards welcome! No extra charge! 


